fix: Restore mdbook to cargo_crates and add devcontainer smoke test (#5647)

Co-authored-by: Claude <[email protected]>

Author: max-sixty

.github/workflows/build-devcontainer.yaml

@@ -58,6 +58,25 @@ jobs:
           cache-from: type=gha,scope=${{ matrix.platform }}
           cache-to: type=gha,mode=max,scope=${{ matrix.platform }}
 
+      # Smoke test: build local image and verify tools work
+      - name: Build local image for smoke test
+        uses: docker/build-push-action@v6
+        with:
+          context: .devcontainer/base-image
+          build-args: cargo_crates=${{ env.cargo_crates }}
+          load: true
+          tags: devcontainer-test:latest
+          cache-from: type=gha,scope=${{ matrix.platform }}
+
+      - name: Smoke test - run tests and build book
+        run: |
+          docker run --rm -v "${{ github.workspace }}:/workspace" -w /workspace \
+            devcontainer-test:latest bash -c "
+              set -euxo pipefail
+              cargo test
+              mdbook build web/book/
+            "
+
       - name: Export digest
         if: inputs.push
         run: |

Taskfile.yaml

@@ -45,11 +45,8 @@ vars:
     rust-lang.rust-analyzer
   cargo_crates: >
     bacon cbindgen cargo-audit cargo-insta cargo-llvm-cov cargo-release
-    cargo-nextest default-target wasm-bindgen-cli wasm-opt
-  # Lock mdbook and plugins to versions compatible with mdbook 0.4.x
-  # (mdbook 0.5.0 has breaking changes)
-  mdbook_crates: >
-    [email protected] [email protected] [email protected]
+    cargo-nextest default-target mdbook mdbook-admonish mdbook-footnote
+    mdbook-toc wasm-bindgen-cli wasm-opt
   # wasm-pack waiting on https://github.com/rustwasm/wasm-pack/issues/1426
   #
   # Excluding `elixir` atm given it's not enabled on Mac and currently unsupported
@@ -132,15 +129,13 @@ tasks:
       # `--locked` installs from the underlying lock files (which is not the
       # default...)
       - "cargo install --locked {{.cargo_crates}}"
-      - "cargo install --locked {{.mdbook_crates}}"
       - cargo install wasm-pack
 
   install-cargo-tools-binstall:
     cmds:
       - cmd: cargo install --locked cargo-binstall
         platforms: [linux, darwin]
       - "cargo binstall -y --locked {{.cargo_crates}}"
-      - "cargo binstall -y --locked {{.mdbook_crates}}"
       - cargo binstall -y wasm-pack
 
   check-vscode-extensions: