🔧 Fix musl compile-fallback gaps and probe-rs crate name 🔧

Root-caused and fixed the remaining tool-inventory gaps found during
this session's verification of the GitHub-rate-limit fix's rebuild.

- Dockerfile: added `apk add openssl-dev openssl-libs-static pkgconfig`
  before the compile-fallback loop — Alpine's openssl-dev only ships
  shared libs, and cargo-public-api/cargo-dist/sea-orm-cli link OpenSSL
  statically against musl, which was failing with `cannot find -lssl`/
  `-lcrypto`. Confirmed fix in a standalone debug container: all three
  now `cargo binstall -y` successfully.
- Dockerfile: fixed `probe-rs` -> `probe-rs-tools` in the main
  prebuilt-fetch loop. `probe-rs` is a library crate with no installable
  binary; the CLI (`probe-rs`, `cargo-flash`, `cargo-embed`) is
  published under `probe-rs-tools`, which has a musl prebuilt via
  QuickInstall. Removed it from the compile-fallback loop since it no
  longer needs it.
- TODO.AI.md: closed the GitHub rate-limiting section (0 403s confirmed
  across a fresh --no-cache multi-platform build); recorded final
  tool-inventory status (6 false positives, 3 fixed, probe-rs fixed,
  cargo-spellcheck documented as a genuine open limitation — its
  hunspell-sys build script SIGSEGVs under this musl cross-compile
  environment even with clang/g++ deps present, not an apk-fixable gap);
  documented the failed `cargo zigbuild` mingw-arm64 workaround attempt
  under the existing mingw-w64-gcc limitation section.

Dockerfile

@@ -159,13 +159,39 @@ RUN --mount=type=cache,id=cargo-registry-native,sharing=shared,target=/usr/local
       cross \
       samply \
       flamegraph \
-      probe-rs \
+      probe-rs-tools \
       sqlx-cli \
       sea-orm-cli; \
     do \
       cargo binstall -y --disable-strategies compile --target "${RUST_TARGET}" "${tool}" || true; \
     done
 
+# A handful of tools ship no prebuilt for musl targets at all (verified via
+# `cargo binstall` "Fallback to cargo-install is disabled" on both amd64 and
+# arm64 — a 404 from every prebuilt source, not a rate-limit issue). For just
+# these, allow the compile fallback: this stage already cross-links via the
+# zig wrapper scripts above, so compiling here is a native cross-build, not
+# QEMU emulation, and stays fast for this small a tool set.
+# openssl-libs-static is required alongside openssl-dev: Alpine's openssl-dev
+# only ships the shared libs, and these tools link OpenSSL statically for the
+# musl target — without it, linking fails with "cannot find -lssl"/"-lcrypto"
+# (reproduced and confirmed in a standalone debug container this session).
+RUN apk add --no-cache openssl-dev openssl-libs-static pkgconfig
+RUN --mount=type=cache,id=cargo-registry-native,sharing=shared,target=/usr/local/cargo/registry \
+    --mount=type=cache,id=cargo-git-native,sharing=locked,target=/usr/local/cargo/git \
+    --mount=type=secret,id=github_token,env=GITHUB_TOKEN,required=false \
+    set -o pipefail; \
+    RUST_TARGET="$(cat /tmp/rust-target)"; \
+    for tool in \
+      taplo-cli \
+      cargo-public-api \
+      cargo-spellcheck \
+      cargo-dist \
+      sea-orm-cli; \
+    do \
+      cargo binstall -y --target "${RUST_TARGET}" "${tool}" || true; \
+    done
+
 FROM ${PULL_URL}:${DISTRO_VERSION} AS build
 ARG TZ
 ARG USER

TODO.AI.md

@@ -1,40 +1,67 @@
 # TODO.AI.md
 
-## GitHub API rate-limiting drops most cross tools on arm64
+## GitHub API rate-limiting drops most cross tools on arm64 — CLOSED
 
-Verified 2026-08-21: a pushed multi-platform build (`docker.io/casjaysdev/rust:latest`,
+Verified 2026-08-21, re-verified after fix: a pushed multi-platform build
-`linux/amd64,linux/arm64`) hit unauthenticated GitHub API rate-limiting (60 req/hr) during
+(`docker.io/casjaysdev/rust:latest`, `linux/amd64,linux/arm64`) originally hit
-the `rust-tools` stage's `cargo binstall` tool loop, because both platforms build
+unauthenticated GitHub API rate-limiting (60 req/hr) during the `rust-tools` stage's
-concurrently against the same shared, unauthenticated budget.
+`cargo binstall` tool loop, because both platforms build concurrently against the same
+shared, unauthenticated budget.
 
-Verified tool inventory in the pushed image:
+Fix applied: `Dockerfile`'s `rust-tools` stage `cargo binstall` `RUN` now accepts an
+optional BuildKit secret (`--mount=type=secret,id=github_token,env=GITHUB_TOKEN,
+required=false`), matching the existing pattern in the sibling `go` image's Dockerfile.
+The local build wrapper now supplies `--secret id=github_token,env=GITHUB_ACCESS_TOKEN`
+on the real `docker buildx build` invocation (confirmed via `pgrep -af`).
 
-- `linux/amd64`: 14 of 60 tools missing (`cargo-edit`, `cargo-update`, `typos-cli`,
+**Confirmed resolved:** a fresh, wrapper-invoked, `--no-cache` multi-platform build
-  `taplo-cli`, `wasm-bindgen-cli`, `cargo-binutils`, `cargo-public-api`,
+(runtime 1h37m) produced **0** `403 Forbidden` errors across the full build log
-  `cargo-spellcheck`, `cargo-dist`, `cargo-fuzz`, `flamegraph`, `probe-rs`, `sqlx-cli`,
+(`grep -c '403 Forbidden' /root/.local/log/buildx/docker.io/casjaysdev/rust/all.log` → 0).
-  `sea-orm-cli`)
-- `linux/arm64`: 40 of 60 tools missing (nearly the whole list, cascading from
-  `cargo-binstall` itself onward once the rate limit was exhausted)
 
-Fix applied in this session: `Dockerfile`'s `rust-tools` stage `cargo binstall` `RUN` now
+## Tool-inventory gap — final status
-accepts an optional BuildKit secret (`--mount=type=secret,id=github_token,env=GITHUB_TOKEN,
-required=false`), matching the existing pattern already present in the sibling `go` image's
-Dockerfile. This raises the GitHub API rate limit from 60 to 5000 req/hr when a token is
-supplied.
 
-**Still open — outside this repo's scope:** the local build wrapper
+Raw `command -v` check against the fixed, pushed image originally reported 12 tools
-(`/usr/local/bin/buildx` → `/usr/local/share/CasjaysDev/scripts/bin/buildx`, a shared
+"MISSING" on amd64. Manual verification found 6 were false positives (crate name ≠
-CasjaysDev script, not owned by this repo) does not pass `--secret id=github_token,
+binary name) and 6 were genuine gaps. All genuine gaps have now been investigated and
-env=GITHUB_TOKEN` on any `docker buildx build` invocation it generates — confirmed by
+either fixed or root-caused:
-grepping the saved build command in `/root/.config/myscripts/buildx/scripts/casjaysdev/
-rust-latest.sh`. Until that wrapper is updated (or the build is invoked manually with the
-secret flag), this Dockerfile fix has no effect and future pushed builds will keep hitting
-the same rate limit. This also affects the `go` image, which has carried the same
-secret-mount plumbing without the wrapper ever supplying it.
 
-Needs a decision from the user: fix the shared wrapper script (affects all dockersrc/
+**False positives (no fix needed, binary confirmed working under its real name):**
-casjaysdevdocker image builds, not just this repo), or accept manual
+`cargo-edit`→`cargo-add`/`cargo-rm`/`cargo-upgrade`/`cargo-set-version`,
-`--secret id=github_token,env=GITHUB_TOKEN` invocation for now.
+`cargo-update`→`cargo-install-update`, `typos-cli`→`typos`, `taplo-cli`→`taplo`,
+`wasm-bindgen-cli`→`wasm-bindgen`, `cargo-binutils`→`cargo-nm`/`cargo-objdump`/
+`cargo-size`/`cargo-strip`.
+
+**Fixed this session:**
+- `cargo-public-api`, `cargo-dist`, `sea-orm-cli` — root cause: these 3 crates have no
+  musl prebuilt (any platform) and fall through to the compile-fallback loop, where
+  linking failed with `cannot find -lssl` / `cannot find -lcrypto`. Alpine's
+  `openssl-dev` package ships only the shared libs; static linking against musl needs
+  `openssl-libs-static` for `libssl.a`/`libcrypto.a`. Reproduced and fixed in a
+  standalone debug container (`rust:alpine`, manual `apk add openssl-libs-static`), then
+  confirmed all 3 now `cargo binstall -y` successfully (exit 0). Fix applied: added
+  `RUN apk add --no-cache openssl-dev openssl-libs-static pkgconfig` immediately before
+  the compile-fallback loop in `Dockerfile`.
+- `probe-rs` — root cause: wrong crate name in the tool list. The `probe-rs` crate is a
+  library with no installable binary (`cargo binstall` error: "no binaries specified nor
+  inferred"); the CLI binaries (`probe-rs`, `cargo-flash`, `cargo-embed`) are published
+  under the `probe-rs-tools` crate, which **does** have a musl prebuilt via QuickInstall
+  (installs in ~2s, no compile needed). Fix applied: changed `probe-rs` → `probe-rs-tools`
+  in the main prebuilt-fetch loop and removed it from the compile-fallback loop (no
+  longer needed there).
+
+**Genuine remaining limitation — documented, not fixed:**
+- `cargo-spellcheck` — no musl prebuilt; compile-fallback fails. Root cause is deeper
+  than a missing package: after installing `openssl-libs-static`, `g++`, and
+  `clang22-libclang` (to satisfy successive `cc`/`c++`/`libclang.so` errors), the build
+  still fails — the `hunspell-sys` dependency's build script
+  (`hunspell-sys-*/build-script-build`) crashes with `SIGSEGV` (signal 11) while
+  compiling the vendored C++ `hunspell` library, not a missing-dependency error. This is
+  a crash inside a third-party build script under this musl cross-compile environment,
+  not something fixable with an `apk add` line; not pursued further given the size of
+  the additional dependencies required (`llvm`/`clang` ~480MiB in the intermediate stage
+  alone) for a tool that still doesn't build. Left in the compile-fallback loop with
+  `|| true` — will keep silently skipping on every build until upstream `hunspell-sys`
+  or `cargo-spellcheck` fixes the underlying crash.
 
 ## mingw-w64-gcc has no arm64 Alpine package
 
@@ -49,3 +76,11 @@ This is an Alpine package-availability limitation (mingw-w64-gcc is not publishe
 aarch64 in the Alpine repos as of this check), not a bug in this repo's scripts. No
 in-repo fix available; document as a known limitation if not already covered by README's
 existing Windows-MSVC/macOS-SDK caveats section.
+
+**Workaround tested and failed:** `cargo zigbuild --target x86_64-pc-windows-gnu` was
+tried on the arm64 image as a substitute cross-linker (zig is already used elsewhere in
+this Dockerfile for musl cross-linking). It compiled the test crate but failed at link
+time: `error: linking with .../zigcc-x86_64-pc-windows-gnu-*.sh failed: exit status: 1`,
+no `.exe` produced (full log: `/tmp/zigbuild_test.log`, not preserved in-repo). Not a
+working substitute — the arm64 `mingw-w64-gcc` limitation remains open with no known
+workaround.