Skip to content

Commit 883dfed

Browse files
docs(agents): add Windows CI toolchain constraint to prevent regressions
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 7043f5b commit 883dfed

1 file changed

Lines changed: 10 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,16 @@ Three directories are involved — do NOT cross-link them:
8484

8585
`cargo.yml` adds `~/.cargo/bin` to PATH so rustup tools are always findable. The `_setup-cargo-home` task symlinks project-local `CARGO_HOME/bin/` to `~/.cargo/bin/` — never to the mise install dir, which has its own internal symlink structure.
8686

87+
### Windows CI Toolchain Constraint
88+
89+
On Windows CI runners, `RUSTUP_TOOLCHAIN` MUST use the fully qualified name with host triple suffix (e.g. `nightly-2026-02-09-x86_64-pc-windows-msvc`). Bare channel names like `nightly-2026-02-09` resolve using the runner's default host triple, which can be stale GNU — causing `dlltool.exe` not found errors. See [Build Configuration — Windows Toolchain Pinning](docs/builds.md#windows-toolchain-pinning) for details.
90+
91+
When modifying `taskfiles/ci.yml` or `.github/actions/setup-tauri-build/action.yml`:
92+
93+
- Never set `RUSTUP_TOOLCHAIN` to a bare toolchain name on Windows
94+
- Always run `rustup set default-host x86_64-pc-windows-msvc` before toolchain installation
95+
- Pass `PINNED_RUST` explicitly from the composite action rather than relying on shell extraction in Task
96+
8797
## Queue and Shuffle Behavior
8898

8999
The queue store (`app/frontend/js/stores/queue.js`) maintains tracks in **play order** — the `items` array always reflects the order tracks will be played.

0 commit comments

Comments
 (0)