fix(shell): provide C linker for Rust browser install

- Add build-essential to generated project images before cargo install
- Assert Dockerfile templates keep the cc toolchain needed by Rust build scripts

Root cause: cargo install of rust-browser-connection failed in E2E images with linker 'cc' not found.

Author: skulidropek

packages/app/src/lib/core/templates/dockerfile-prelude.ts

@@ -9,13 +9,13 @@
 // COMPLEXITY: O(1)/O(1)
 const dockerGitBaseImage = "konard/box-js:2.1.1"
 
-// CHANGE: include tmux in generated project images for durable terminal multiplexing.
-// WHY: stable project SSH links attach to persisted tmux sessions instead of one-off shell processes.
+// CHANGE: include tmux and build-essential in generated project images for durable sessions and Rust crate installation.
+// WHY: stable project SSH links need persisted tmux sessions, and cargo install of proc-macro/build-script dependencies requires a C linker.
 // QUOTE(ТЗ): n/a
 // REF: PR-309
 // SOURCE: n/a
 // PURITY: CORE
-// INVARIANT: generated base image contains the terminal multiplexer required by project SSH sessions.
+// INVARIANT: generated base image contains both the terminal multiplexer and cc toolchain required before Rust browser CLI installation.
 // COMPLEXITY: O(1)/O(1)
 const renderDockerfileBase = (): string =>
   `ARG DOCKER_GIT_BASE_IMAGE=${dockerGitBaseImage}
@@ -48,7 +48,7 @@ RUN set -eu; \
   done; \
   apt-get -o Acquire::Retries=3 install -y --no-install-recommends \
     openssh-server git gh ca-certificates curl unzip bsdutils sudo tmux \
-    make docker.io docker-compose-v2 bash-completion zsh zsh-autosuggestions xauth \
+    make build-essential docker.io docker-compose-v2 bash-completion zsh zsh-autosuggestions xauth \
     ncurses-term jq \
   && rm -rf /var/lib/apt/lists/*`
 

packages/app/tests/docker-git/core-templates.test.ts

@@ -63,6 +63,7 @@ describe("app planFiles", () => {
     expect(dockerfile.contents).toContain(
       "cargo install --git https://github.com/ProverCoderAI/rust-browser-connection"
     )
+    expect(dockerfile.contents).toContain("make build-essential docker.io")
     expect(dockerfile.contents).toContain("docker-git-playwright-mcp")
     expect(entrypoint.contents).toContain("docker_git_start_rust_browser_connection")
     expect(entrypoint.contents).toContain("docker-git-browser-connection")

packages/lib/src/core/templates/dockerfile-prelude.ts

@@ -9,13 +9,13 @@
 // COMPLEXITY: O(1)/O(1)
 const dockerGitBaseImage = "konard/box-js:2.1.1"
 
-// CHANGE: include tmux in generated project images for durable terminal multiplexing.
-// WHY: stable project SSH links attach to persisted tmux sessions instead of one-off shell processes.
+// CHANGE: include tmux and build-essential in generated project images for durable sessions and Rust crate installation.
+// WHY: stable project SSH links need persisted tmux sessions, and cargo install of proc-macro/build-script dependencies requires a C linker.
 // QUOTE(ТЗ): n/a
 // REF: PR-309
 // SOURCE: n/a
 // PURITY: CORE
-// INVARIANT: generated base image contains the terminal multiplexer required by project SSH sessions.
+// INVARIANT: generated base image contains both the terminal multiplexer and cc toolchain required before Rust browser CLI installation.
 // COMPLEXITY: O(1)/O(1)
 const renderDockerfileBase = (): string =>
   `ARG DOCKER_GIT_BASE_IMAGE=${dockerGitBaseImage}
@@ -48,7 +48,7 @@ RUN set -eu; \
   done; \
   apt-get -o Acquire::Retries=3 install -y --no-install-recommends \
     openssh-server git gh ca-certificates curl unzip bsdutils sudo tmux \
-    make docker.io docker-compose-v2 bash-completion zsh zsh-autosuggestions xauth \
+    make build-essential docker.io docker-compose-v2 bash-completion zsh zsh-autosuggestions xauth \
     ncurses-term jq \
   && rm -rf /var/lib/apt/lists/*`
 

packages/lib/tests/core/templates.test.ts

@@ -89,6 +89,7 @@ describe("renderDockerfile", () => {
 
     expect(dockerfile).toContain("ARG DOCKER_GIT_BASE_IMAGE=konard/box-js:2.1.1")
     expect(dockerfile).toContain("FROM ${DOCKER_GIT_BASE_IMAGE}")
+    expect(dockerfile).toContain("make build-essential docker.io")
     expect(dockerfile).toContain(
       "#checkov:skip=CKV_DOCKER_8: docker-git entrypoint must start as root to prepare SSH/auth/bootstrap and run sshd"
     )