Skip to content

fix(unity-test-runner): inline results-check templates instead of reading from disk - #224

Merged
frostebite merged 3 commits into
mainfrom
fix/unity-test-runner-results-check-templates
Aug 28, 2026
Merged

frostebite merged 3 commits into
mainfrom
fix/unity-test-runner-results-check-templates

Conversation

@frostebite

@frostebite frostebite commented Aug 28, 2026

Copy link
Copy Markdown
Member

Summary

  • Fixes all 78 failing checks on Thin wrapper: invoke game-ci/cli as a subprocess unity-test-runner#310's CI: tests actually pass, but a post-run step crashed with ENOENT: no such file or directory, open '.../dist/results-check-summary.hbs'.
  • renderSummary/renderDetails read two tiny Handlebars templates via Action.actionFolder, which resolves relative to the compiled action module's own on-disk location. That assumption holds for the plugin's own standalone tsc build (where src/**/dist/ static assets get copied alongside the compiled .js by copy-static-assets.mjs), but not for the actual runtime path: a bun build --compile binary doesn't preserve that per-plugin dist/ staging layout as a sibling on disk.
  • Since these two templates are tiny, static, and never need to be a real file on disk (no Docker volume mount depends on them, unlike default-build-script/, platforms/*, etc.), the fix inlines them as string constants in a new results-check-templates.ts instead of reading them from disk at runtime — sidesteps the whole path-resolution problem.

Test plan

Summary by CodeRabbit

  • Bug Fixes
    • Improved Unity test result reporting reliability in bundled and compiled environments.
    • Prevented failures caused by missing template files when generating test summaries and detailed results.
  • Refactor
    • Updated report rendering to use built-in templates, ensuring consistent output across deployment formats.

…ding from disk

All matrix jobs on game-ci/unity-test-runner#310's CI were failing with
ENOENT: results-check-summary.hbs, thrown after tests had already run and
passed. renderSummary/renderDetails read these two tiny templates via
Action.actionFolder, which resolves relative to the compiled action's own
on-disk location - a path that doesn't exist for a bundled/compiled
game-ci binary, since it doesn't ship the plugin's own src/**/dist/
staging layout as a sibling.

Inline both templates as string constants instead, matching how small,
static, non-Docker-mount text like this has no real reason to depend on
filesystem path resolution at all.
Not needed - the previous commit inlines both templates instead, so
these copies (an earlier, superseded attempt at fixing the same issue
by shipping the .hbs files alongside the binary) are dead weight.
@coderabbitai

coderabbitai Bot commented Aug 28, 2026

Copy link
Copy Markdown

Review Change Stack

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (4)
  • plugins/unity/dist/unity-test-runner/model/results-check-templates.d.ts is excluded by !**/dist/**
  • plugins/unity/dist/unity-test-runner/model/results-check-templates.js is excluded by !**/dist/**
  • plugins/unity/dist/unity-test-runner/model/results-check.d.ts is excluded by !**/dist/**
  • plugins/unity/dist/unity-test-runner/model/results-check.js is excluded by !**/dist/**

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 143b835d-0af4-43e1-a86c-02bceac73ecd

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 1aa0eee8-f2cb-4970-83ea-ec6b82e4429b

📥 Commits

Reviewing files that changed from the base of the PR and between f0b6097 and 8f8d633.

📒 Files selected for processing (2)
  • plugins/unity/src/unity-test-runner/model/results-check-templates.ts
  • plugins/unity/src/unity-test-runner/model/results-check.ts

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

ResultsCheck now renders Unity test summaries and details from imported Handlebars template constants. It no longer builds template paths or reads template files from disk.

Changes

Unity results rendering

Layer / File(s) Summary
Inline result templates
plugins/unity/src/unity-test-runner/model/results-check-templates.ts
Adds exported Handlebars templates for run summaries and detailed suite and test output.
ResultsCheck template integration
plugins/unity/src/unity-test-runner/model/results-check.ts
Passes the imported template sources to render, which no longer reads templates from disk.

Estimated code review effort: 2 (Simple) | ~10 minutes

Merge Risk: ⚪ Minimal · up to 8f8d6

This PR replaces fragile runtime template-file lookups with bundled template strings while preserving result rendering. No actionable merge-blocking risk remains after normal checks and review.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely describes the main change: inlining Unity test-runner result templates instead of reading them from disk.
Description check ✅ Passed The description explains the failure, root cause, implementation, and test results. It does not use the repository template headings or include the required contribution-guide and README checklist ite…
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 2…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Description check

Explanation

The description explains the failure, root cause, implementation, and test results. It does not use the repository template headings or include the required contribution-guide and README checklist items, but it provides the essential change and validation information.

Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 2 files.

✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Create stacked PR
  • Commit on current branch
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/unity-test-runner-results-check-templates

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

…k templates

'bun run build' output for results-check.ts's switch to
results-check-templates.ts, plus the new compiled file itself - CI's
"Verify dist is up to date" gate caught this being stale.
@frostebite
frostebite merged commit e63ebca into main Aug 28, 2026
15 checks passed
@frostebite
frostebite deleted the fix/unity-test-runner-results-check-templates branch August 28, 2026 14:28
frostebite added a commit to game-ci/unity-test-runner that referenced this pull request Aug 28, 2026
… ENOENT fix

All matrix jobs on this PR's CI were failing after tests passed with
ENOENT: results-check-summary.hbs - the actual bug (results-check.ts
reading a template from a disk path that doesn't exist in a compiled
binary) was fixed in game-ci/cli#224, but that fix never reached this
repo: src/index.ts imports ResultsCheck from
@game-ci/unity-engine-core, a git+workspace dependency pinned to a
specific game-ci/cli commit SHA predating that fix - a completely
separate distribution channel from the CLI's own GitHub releases
(v0.1.x), which is what earlier verification here actually checked.

Bumped the pinned commit to game-ci/cli's current main HEAD
(6003d282, includes #224/#225/#227/#228), reinstalled, and rebuilt.
Verified: dist/index.js no longer contains the old disk-read pattern
and does contain the new inlined RESULTS_CHECK_SUMMARY_TEMPLATE.
frostebite added a commit to game-ci/unity-test-runner that referenced this pull request Aug 29, 2026
* Make action a thin wrapper around game-ci/unity-engine-core

Delegates test-runner logic to the extracted implementation in
game-ci/unity-engine-core instead of maintaining a local copy, per
game-ci/roadmap#11 workstream 2 (Option A) — second engine repo to
make this move, following unity-activate. src/model/*, src/main.ts,
src/post.ts, src/views/* are removed; build/test coverage now lives
in the destination repo.

The wrapper's own checked-in dist/ (main.js, post.js, the .hbs
templates, platform scripts) is unchanged — Action.actionFolder still
resolves to this repo's own dist/ once ncc bundles unity-engine-core's
code into it, so those static assets stay exactly where they already
were.

* fix: pin @game-ci/unity-engine-core to a commit SHA, not the mutable main ref

Flagged by CodeRabbit on this PR: the git dependency selector
"game-ci/unity-engine-core#main" resolves whatever main happens to point
to at install time, rather than the exact commit this PR was reviewed
against. Pinned to e49341a2e524f830f2e2965fd84dd65f0ffce48c (main's tip,
now frozen since the repo was archived in favor of game-ci/cli's
plugins/unity/). yarn.lock regenerated; `yarn install --immutable` and
`yarn typecheck` both verified clean against the new pin.

* fix: depend on game-ci/cli's plugins/unity workspace, not archived unity-engine-core

game-ci/unity-engine-core is archived - its content now lives in-repo at
game-ci/cli's plugins/unity/ (same package name, @game-ci/unity-engine-core,
via git subtree with full history preserved). Pointing this dependency at
the standalone archived repo still worked (archiving doesn't remove
anything), but kept an external dependency alive on a repo we've
deliberately retired in favor of the monorepo.

Now resolves via yarn's git+workspace protocol
(game-ci/cli#commit=<sha>&workspace=@game-ci/unity-engine-core), pulling
the same package straight out of cli's workspace instead. Verified:
`yarn install`, `yarn typecheck`, `yarn build`, and `yarn test` all pass
clean against the new resolution.

* fix: merge main + bump unity-engine-core pin to pick up shm-size fix

Merges main (unity-test-runner#308's --shm-size=1025m fix) - that commit
touched src/model/docker.ts, which this branch already deleted, so the
fix itself wasn't carried over by the merge. Ported separately to where
the logic now lives (game-ci/cli#92, plugins/unity/src/unity-test-runner/
model/docker.ts) and bumped this branch's pinned commit to cli's new main
(757d85f) to pick it up. Verified the resolved package actually contains
the fix, then typecheck/build/test all pass clean.

* fix: bump unity-engine-core pin to pick up docker-launch retry fix

Picks up game-ci/cli#93 (retries transient docker.exe launch failures,
addressing unity-test-runner#314's Windows CI flake). Verified the
resolved package contains the fix, then typecheck/build pass clean.

* feat: convert to a genuine thin wrapper, shelling out to game-ci/cli

Completes the "actions invoke cli" migration (game-ci/roadmap#11
workstream 2) for the third and last action - unity-activate (#111)
and unity-builder (#844) already made this move. Was blocked on
game-ci/cli#71 (cli's `test` command had no Docker-based mode matching
this action's real feature surface); that's now closed by
game-ci/cli#95.

This action now downloads the game-ci CLI binary and shells out to its
`test --docker` command for the actual Docker/test execution, instead
of importing @game-ci/unity-engine-core's logic as an in-process
library (this branch's previous approach, from the earlier commits on
this same branch). The same binary, the same command, whether run in
CI or by a developer locally.

GitHub Checks reporting (githubToken/checkName) isn't something
`game-ci test` does itself yet - this wrapper still imports
ResultsCheck from @game-ci/unity-engine-core (the same already-
extracted, already-tested module the previous approach used) to post
results after the CLI subprocess exits. Genuinely hybrid: subprocess
for execution, library import only for the one piece of reporting
logic the CLI doesn't cover.

- src/test-args.ts: translates action inputs to `game-ci test --docker`
  flags. testMode -> testPlatforms conversion, package-mode validation/
  packageName derivation (from package.json) and Tests-folder check are
  ported directly from the original Input.ts, since cli's DockerTestOptions
  expects an already-derived packageName rather than deriving it itself.
  Always passes --dockerShmSize=1025m, matching what #308 hardcoded
  unconditionally in this repo's own Docker.run before extraction - not a
  new user-facing input, just preserving prior behavior.
- src/download-cli.ts: copied verbatim from unity-builder - fully
  generic, nothing build-specific in it.
- src/index.ts: rewritten. Notably, game-ci test --docker's exit code
  now genuinely reflects test pass/fail (2 = some tests failed) rather
  than the old flow's GH-token-gated "always exit 0, let the caller
  inspect the XML" mode - that was a GitHub Actions-specific
  accommodation the CLI has no reason to replicate. So: with a
  githubToken, this defers entirely to ResultsCheck's own verdict
  (still posts the detailed check on failure, which is when it matters
  most) rather than bailing out on the raw exit code first; without a
  token, the exit code is the only signal available. Exit codes other
  than 0/2 (docker/licensing/infra failures, not test failures) skip
  ResultsCheck entirely rather than parsing missing/partial XML.
- action.yml: added cliVersion (matching unity-activate/unity-builder)
  and coverageEnabled (#311's opt-out, not merged to main yet but
  already supported by cli#95 - ported here too rather than leaving a
  known gap). Simplified to a single main entrypoint, dropping the
  post step and its container-cleanup-on-crash logic - the CLI
  subprocess's own `docker run --rm` handles this now, same
  simplification unity-builder's conversion made.
- Deleted dist/BlankProject, dist/platforms/*, dist/test-standalone-scripts,
  dist/unity-config, dist/main.js, dist/post.js, dist/results-check-*.hbs:
  all dead under the new structure, matching exactly what unity-builder#844
  removed - the Docker orchestration they supported now runs entirely
  inside the cli binary, which carries its own copies.

Known gaps, not silently dropped:
- unityVersion overrides ignored for full projects (same CLI limitation
  as build/activate) - required and enforced for packageMode, where the
  CLI has no project checkout to detect a version from at all.
- --docker/--local (game-ci/cli#95) are Linux-only for now, so this
  thin wrapper is too until Windows support lands there.

Testing: yarn typecheck clean, yarn test 17 pass (new test-args.test.ts
covering testMode conversion, packageMode validation/derivation,
coverageEnabled toggle, string/boolean flag mapping), yarn build
(tsc && ncc) succeeds, yarn lint 0 errors (5 pre-existing-pattern
no-explicit-any warnings, matching unity-builder's own thin-wrapper
code including the verbatim-copied download-cli.ts).

* feat: cache the game-ci CLI download even when cliVersion=latest

Ports the same fix already shipped on unity-builder's and
unity-activate's thin-wrapper branches: resolve "latest" to its
concrete release tag via the GitHub API first, then cache under that
resolved tag instead of leaving "latest" permanently uncached.

Also documents the CodeQL js/command-line-injection false positive on
the exec.exec call (args derive from Action inputs but are passed as
discrete argv entries, never shell-parsed).

* fix: use the working inline Unity license instead of the stale secret

Every Unity job in this workflow failed activation. activate.sh wrote the
ULF and reported "Activation complete", but the Editor then rejected it:
"No valid Unity Editor license found" / "Unable to update licenses.
Errors: No ULF license found." The org-level UNITY_LICENSE secret this
workflow reads is stale.

Note UNITY_LICENSE takes precedence over UNITY_SERIAL in activate.sh (the
serial branch is an elif), so having UNITY_EMAIL/UNITY_PASSWORD set here
never provided a fallback - the bad ULF always won.

Switches to the same inline Unity Personal license that
game-ci/unity-builder's build-tests-ubuntu.yml and game-ci/unity-activate's
main.yml already use - both green today, verified byte-identical to
unity-builder's copy. It carries ValidTo="9999-12-31" and is already
published in those public repos, so it is not a credential to protect.

This also restores fork-PR support: secrets are not exposed to pull
requests from forks, so a secret-based license fails every external
contributor's PR. That is why the license was inline here originally,
before "secure license (#92)" moved it to a secret.

Deliberately NOT applied to unity-builder's mac/windows workflows: their
licensing already succeeds via the professional UNITY_SERIAL path, and
because UNITY_LICENSE wins precedence, inlining a personal ULF there would
override working activation. (Their failures are a real build error -
"Incremental Player build failed! Errors: 4" - not licensing.)

Committed with --no-verify: the pre-commit actionlint hook fails on this
repo's own action.yml ("invalid runner name node24"), which is
pre-existing on main and unrelated to this change - the pinned actionlint
build predates GitHub's node24 action runtime.

* Revert "fix: use the working inline Unity license instead of the stale secret"

This reverts da2aa81. Inlining a license blob into the workflow was the
wrong fix - the repo-level UNITY_LICENSE secret has been updated with a
working license instead, so `${{ secrets.UNITY_LICENSE }}` resolves
correctly again and the workflow stays clean.

(Repo-level secrets take precedence over org-level ones, so this is
unaffected by the stale org secret that caused the original failure.)

--no-verify: the pre-commit actionlint hook fails on this repo's own
action.yml ("invalid runner name node24"), pre-existing on main and
unrelated - the pinned actionlint predates GitHub's node24 runtime.

* fix: map unityVersion to --engineVersion instead of ignoring it

This wrapper's own comment claimed "no override flag exists yet", but
game-ci/cli#154 added --engineVersion as exactly that override, for
unity-builder's matching build-args.ts mapping. This wrapper never
picked up the equivalent mapping - unityVersion was validated as
required in package mode, then silently dropped instead of forwarded,
and outside package mode it was ignored with a now-stale warning.

Confirmed via real CI on this branch's own thin-wrapper PR (#310):
every package-mode job failed with "Engine not detected from
projectPath" (a package has no ProjectSettings/ProjectVersion.txt to
auto-detect from at all), and every non-default-version matrix job
pulled the wrong Docker image tag (e.g. unityci/editor:ubuntu-2022.3.7f1-...
when the matrix asked for 2022.3.13f1) - both are exactly what
`test`'s engineDetection middleware does when it never receives an
explicit --engineVersion to prefer over auto-detection.

* chore: fix formatting

* chore: rebuild dist/index.js with the engineVersion mapping fix

The integration test matrix uses this repo's own action (uses: ./),
which reads the committed dist/index.js directly - a source-only
commit never reaches it. This is the rebuild the previous two commits
were missing.

* fix: always pass --engine=unity, fixing packageMode's "Engine not detected"

--engineVersion alone wasn't enough: game-ci/cli's engineDetection
middleware still calls its project-path detector to resolve `engine`
whenever it's unset, even when --engineVersion was already given
explicitly. A bare UPM package directory (packageMode's project layout)
has no ProjectSettings/ProjectVersion.txt for that detector to find, so
every package-mode run failed outright with "Engine not detected from
projectPath" regardless of --engineVersion - confirmed via real CI on
this branch's own thin-wrapper PR (#310).

This wrapper only ever targets Unity, so --engine=unity is passed
unconditionally rather than gated on packageMode - it removes the
dependency on project-path detection entirely, not just for the one
case that was actually failing.

Also rebuilds dist/index.js - the integration test matrix uses this
repo's own action (uses: ./), which reads the committed bundle
directly, not source.

* ci: retrigger verification for cli v0.1.37 (windows license retry, game-ci/cli#200)

* ci: retrigger verification for cli v0.1.38 (license-return retry, seat-leak fix, game-ci/cli#202)

* ci: retrigger verification for cli v0.1.39 (mac/windows personal-license activation, game-ci/cli#204)

* ci: retrigger verification now that UNITY_SERIAL/EMAIL/PASSWORD are synced (game-ci/unity-builder#844)

* ci: retrigger verification for cli v0.1.40 (serial-over-personal-license priority, game-ci/cli#206)

* fix(ci): wire UNITY_SERIAL into main.yml's env block

The repo secret was synced from unity-builder (game-ci/unity-builder#844's
sync-secrets.yml run) but this workflow's env block only ever exposed
UNITY_LICENSE/EMAIL/PASSWORD - UNITY_SERIAL was never read from
secrets.UNITY_SERIAL into any job's actual environment, so
game-ci/cli#206's serial-preferred priority fix had nothing to prefer:
$Env:UNITY_SERIAL was always empty regardless of the secret existing,
and activation kept falling through to the personal-license path,
which fails on Windows with "Machine bindings don't match".

* fix(ci): authenticate download-cli.ts's GitHub API call to avoid rate-limiting

Confirmed live: this repo's large test matrix (85+ jobs) failed widely
with "Failed to resolve the latest game-ci CLI release: GitHub API
returned 403" - every job resolving "latest" around the same time blew
through the unauthenticated 60 req/hour-per-IP limit shared across all
jobs on the runner pool. unity-builder's copy of this same file already
authenticates via GITHUB_TOKEN; this file never got that fix. Wires
GITHUB_TOKEN into main.yml's workflow-level env block so it's available
to authenticate the call.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

* fix: bump @actions/cache to v4 (v3's cache service backend was sunset March 2025)

Same fix already applied to sibling repos (unity-builder, steam-deploy)
this session. The API surface this repo actually uses
(isFeatureAvailable/restoreCache/saveCache) is unchanged.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

* fix: default githubToken to the workflow's own token

Migrated from community PR #210 (closing #209): defaulting to
'\${{ github.token }}' means check-run reporting works out of the box
without users having to wire a token manually - the default GITHUB_TOKEN
already has checks: write permission in the common case.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

* fix: bump @game-ci/unity-engine-core pin to pick up the results-check ENOENT fix

All matrix jobs on this PR's CI were failing after tests passed with
ENOENT: results-check-summary.hbs - the actual bug (results-check.ts
reading a template from a disk path that doesn't exist in a compiled
binary) was fixed in game-ci/cli#224, but that fix never reached this
repo: src/index.ts imports ResultsCheck from
@game-ci/unity-engine-core, a git+workspace dependency pinned to a
specific game-ci/cli commit SHA predating that fix - a completely
separate distribution channel from the CLI's own GitHub releases
(v0.1.x), which is what earlier verification here actually checked.

Bumped the pinned commit to game-ci/cli's current main HEAD
(6003d282, includes #224/#225/#227/#228), reinstalled, and rebuilt.
Verified: dist/index.js no longer contains the old disk-read pattern
and does contain the new inlined RESULTS_CHECK_SUMMARY_TEMPLATE.

* fix: bump @game-ci/unity-engine-core pin to pick up the explicit-docker-pull fix

game-ci/cli#229 fixes the root cause of this PR's remaining "Test all
modes" Windows failures: docker run's implicit pull folded a 16-minute
partial-cache-miss pull into the same session as Unity's license
activation, causing the license return to fail once the container
finally started. Docker.run now pulls explicitly, before that window
opens.

* fix: remove accidentally-committed stale test result files, gitignore artifacts/

Root-caused the "Test all modes" windows-2022 failures on #310's CI:
all 3 Unity versions failed with real-looking test-content failures
(4/14 passed, 6 failed), but the counts were an EXACT match for
artifacts/{editmode,playmode}-results.xml as committed back in 2021
(#104's "Small results-check refactor for debugging") -
testcasecount=6/passed=2/failed=2/skipped=2 and
testcasecount=8/passed=2/failed=4/skipped=2 respectively, timestamped
2021-01-19. Ubuntu's "Test all modes" jobs (same fixture, same Unity
versions) reported clean 7/7 results every time.

These were never gitignored, so every fresh checkout - including CI's
own - starts with these 4-year-old stale XML files already sitting at
the exact path the results-check step reads from. Ubuntu's real test
run successfully overwrites them before the check happens; on Windows
specifically, for whatever reason, the fresh write either doesn't land
in time or doesn't land at the same path, so the ancient committed
copy gets parsed as if it were this run's real result - explaining
both the seemingly-real failures (they ARE real NUnit XML, just from
2021) and why they were windows-and-testMode=all-specific (that's
whichever combination happens to expose the write-timing/path gap).

Removing the stale files and gitignoring artifacts/ fixes this
unconditionally regardless of the underlying Windows write-timing
question: with no file present at checkout, there's nothing stale left
to accidentally parse on any platform.

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant