Skip to content

Add Windows to the CI matrix and cache the managed Bun download - #24

Merged
arcaputo3 merged 6 commits into
agent/idiomatic-scalajs-mill-workflowsfrom
agent/bun-windows-ci
Aug 27, 2026
Merged

Add Windows to the CI matrix and cache the managed Bun download#24
arcaputo3 merged 6 commits into
agent/idiomatic-scalajs-mill-workflowsfrom
agent/bun-windows-ci

Conversation

@arcaputo3

Copy link
Copy Markdown
Contributor

Stacked on #23 (agent/bun-honest-defaults).

Why

The plugin carries Windows-specific code — bun.exe zip extraction, executableCandidates,
mill.bat selection in the integration harness — with zero coverage. Worse: build.mill
selects workspaceRoot / "mill.bat" as the fixture Mill executable on Windows, and that file
never existed in the repository, so the integration suite could not have forked a single fixture
build on Windows at all.

What changes

  • windows-latest joins both CI matrices (build = system Bun via setup-bun, managed-bun
    = download/extract/cache path), with fail-fast: false so one platform's failure doesn't mask
    another's results.
  • Steps run under shell: bash on every platform, so the single ./mill wrapper invocation
    works on the Windows runner (git-bash) too.
  • The official Mill 1.1.5 mill.bat launcher is committed (fetched from
    com.lihaoyi:mill-dist:1.1.5, classifier mill.bat), completing the Windows fork path the
    harness already pointed at.
  • ~/.cache/mill-bun is cached in both jobs, keyed on the toolchain source file — a
    managed-Bun run downloads each pinned archive once per platform instead of once per CI run,
    and a version bump (which edits that file) invalidates the key automatically.

Expectations

This leg exists to surface pre-existing Windows breakage, per the sweep plan — first-run
failures here are findings, not regressions. Known candidates from review: os.symlink on
runners without the privilege (GitHub's Windows runners are Administrators, so likely fine), and
path handling in fixture assertions. Triage happens on this PR.

arcaputo3 and others added 4 commits August 26, 2026 19:22
…v hooks

The TypeScript install task is canonically bunInstall; Mill's inherited
npmInstall delegates to it and stays usable. All internal call sites use
the canonical name, so install artifacts live in bunInstall.dest.

Both module kinds share one test entrypoint name: testForked. The
TypeScript test command `test` is a deprecated alias, and the Scala.js
bunTest — which duplicated the inherited testForked exactly, since the
overridden jsEnvConfig and testLinkTask already put every test run on
Bun — is deprecated in its favor.

TypeScript bunBundleFormat is Option[String], matching Scala.js. The
type disagreement was the one rename no alias could bridge; 0.3.0 takes
the one-time break, and None now lets `bun build` infer the format.
BunWorkersModule.workerBundleFormat follows it directly.

Environment hooks share one vocabulary: bunToolEnv (install, lock,
build subprocesses) is defined once on BunToolchainModule and used by
every runBun call site — Scala.js, TypeScript, workspace, publish, and
workers modules previously mixed bunEnv() and bunToolEnv() — and the
TypeScript bunRuntimeEnv is public instead of protected.

Integration tests exercise the canonical names throughout, with
explicit alias regression coverage: npmInstall must resolve to
bunInstall.dest, and the deprecated test / bunTest commands must keep
working until their removal at 1.0. MIGRATING-0.3.md documents the new
rows and the bunBundleFormat break with a before/after example.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
build.mill forced MILL_BUN_REQUIRE_LOCKFILE=false across the entire
integration suite, so the strict-lockfile default — the plugin's
headline 0.3.0 behavior — was exercised by almost nothing. Every
install-path bug fixed earlier in this stack lived in exactly that gap.

All 13 real-bun dependency-bearing fixtures now commit a bun.lock
generated by the pinned Bun 1.4.0 and install frozen in CI. The
RegenerateFixtureLocks entry point re-locks every fixture in one
command (MILL_BUN_REGENERATE_LOCKS=1 gates it; without the env it lists
what it would do and touches nothing). The forkEnv default is removed;
scalajs-dependency-manifests opts out in its own build.mill because its
stub cannot produce a real lock.

scalajs-transitive is restructured: lib and app both claimed the
workspace root as moduleDir, so both resolved the same bun.lock and
only one dependency set could be recorded there. lib now lives in lib/
with its own lockfile identity.

Committed locks make the Bun pin load-bearing — bun.lock is forward-
but not backward-compatible, and the raw UnknownLockfileVersion error
from an older Bun never mentions how to recover. A frozen install
against a lock the pinned Bun cannot read now fails before bun runs,
telling the user to regenerate with bunLock or raise bunVersion. The
supported-lockfile-version table lives beside the checksum table, and a
unit test forces every bundled Bun to declare its entry.

The new typescript-stale-lock fixture proves the guard fires before any
bun subprocess is reached, and fails with the guard neutralized.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The plugin carries Windows-specific code — bun.exe extraction,
executableCandidates, the mill.bat fork path in the integration
harness — with zero coverage. Both jobs now run on windows-latest with
fail-fast off, using bash as the step shell so one ./mill invocation
works on all three platforms. The official Mill 1.1.5 mill.bat launcher
is committed; build.mill already selects it on Windows, but it never
existed, so the integration suite could not have forked a fixture build
there at all.

Both jobs also cache ~/.cache/mill-bun keyed on the toolchain source,
so a managed-Bun run downloads each pinned archive once per platform
rather than once per CI run.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The sh wrapper fetches Mill's native launcher, which has no Windows
build — every Windows step died instantly with "This native mill
launcher supports only Linux and macOS." A launcher-selection step now
points Windows at the committed mill.bat and everything else at ./mill.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
arcaputo3 and others added 2 commits August 26, 2026 20:09
…t there

os.perms throws on NTFS, and bun.exe needs no executable bit — the
permission half of the cross-filesystem publish test now runs only on
POSIX. First genuine Windows finding; the managed-bun leg (download,
extraction, shared cache, eviction recovery, mill.bat forking) already
passes on windows-latest.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The fixture's bun-proxy is a POSIX sh script, which CreateProcess
cannot execute — the only failure in the entire Windows integration
suite. The fixture now carries bun-proxy.cmd with identical semantics
(log first-arg:marker, delegate to PATH bun, propagate the exit code)
and picks the right one per platform.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@arcaputo3
arcaputo3 changed the base branch from agent/bun-honest-defaults to agent/idiomatic-scalajs-mill-workflows August 27, 2026 00:57
@arcaputo3
arcaputo3 merged commit 1d9d000 into agent/idiomatic-scalajs-mill-workflows Aug 27, 2026
6 checks passed
@arcaputo3
arcaputo3 deleted the agent/bun-windows-ci branch August 27, 2026 00:58
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