Windows contributor DX: bun run check, setup and release:test fail on Windows

オープン
#260 コメント 3 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
45/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
bash, bun, github-actions, python, rust, shell

調査の方向性

The first stop is package.json: every script that calls scripts/*.sh directly needs a bash prefix (the failing one is check → scripts/check-skills.sh), and the TS release tests that spawn a script need the same prefix. Then read setup.sh for the Linux hints and add a MINGW/MSYS branch covering MSVC Build Tools, WebView2, Git Bash and actionlint/zizmor, plus a Windows section in docs/contributing.md. Add a Windows CI job running bun run check without Rust; done means a fresh Windows 11 machine gets rc=0 from bun run setup through bun run check.

索引モデルが issue の本文から書いたものです。

説明

area: ci priority: 2 normal status: confirmed type: chore

Observed on one Windows 11 machine (Git Bash, Bun, WSL installed) while gating #259 (gate note: https://github.com/codeatlasdev/atlas/pull/259#issuecomment-6882316955). The release:test failures also happen on main, so they are a pre-existing Windows break, not caused by #259. Causes marked "inferred" were not traced to Bun source.

Contributors on Windows cannot run the repo's own gate today. Found while gating #259 on Windows 11 (Git Bash + Bun):

What breaks

  • bun run check stops after cargo-deny: scripts/check-skills.sh fails with bun: unknown error. Inferred: Bun's script runner on Windows does not execute a .sh file by path (observed: bun: unknown error and EFTYPE uv_spawn). Same for every script that calls scripts/*.sh directly: setup, desktop:dev, desktop:build, lint:workflows, mobile:check, release:*, sweep, icons:dev.
  • release:test: 38 failures with EFTYPE: inappropriate file type or format, uv_spawn, identical on main: the TS tests Bun.spawnSync([script]) on .sh helpers; python3 is not the Windows name (python/py).
  • lint:workflows: actionlint/zizmor not installed and setup.sh does not say how on Windows.
  • setup.sh has hints for Linux packages only; nothing for Windows (WebView2, MSVC Build Tools, cargo-xwin not needed locally, etc.).
  • CI job rust-windows builds and tests Rust, but no CI job runs the scripts or bun run check on Windows, so this regresses silently.

Works by hand: bash scripts/check-skills.sh, bun run desktop:check (3199 tests), Rust fmt/clippy/nextest (1920 tests).

Proposal

  1. Every package.json script runs shell scripts as bash scripts/x.sh (Git Bash is already required for the repo); TS tests spawn ["bash", script]; Python via python3 || python.
  2. setup.sh detects Windows (uname -s MINGW/MSYS) and checks/hints: MSVC Build Tools, WebView2 runtime, Git Bash, cargo nextest, cargo deny, actionlint + zizmor via winget/scoop.
  3. docs/contributing.md: a "Windows" section (prereqs, bun run desktop:dev, what is macOS-only: agent instances, Lab, mirror).
  4. CI: a Windows job running bun run check minus the Rust part (already covered), so script breakage on Windows turns CI red.
  5. Optional later: port the most used scripts (setup, check-changed, heavy) to Bun TS so they need no bash at all.

Done when

A fresh Windows 11 machine with Git, Rust, Bun goes bun run setup → bun run check → rc=0, and CI enforces it.

主要言語
Rust
スター
3
フォーク
1
平均マージ
9時間 51分
マージ済み PR(30日)
310

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

codeatlasdev/atlas のほかの issue

codeatlasdev/atlas の issue をすべて見る

似ている issue

Rust の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。