build(webui-v2): remove generated dist from source control

.dockerignore

@@ -7,3 +7,5 @@ target/
 !crates/**/*.md
 !CLAUDE.md
 node_modules/
+**/node_modules/
+crates/ironclaw_webui_v2_static/static/dist/

.github/workflows/code_style.yml

@@ -159,6 +159,13 @@ jobs:
         uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
         with:
           components: clippy
+      - name: Install Node.js for WebUI bundle builds
+        if: contains(matrix.flags, '--all-features')
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: crates/ironclaw_webui_v2_static/frontend/package-lock.json
       - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2
         with:
           shared-key: clippy
@@ -186,6 +193,13 @@ jobs:
         uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
         with:
           components: clippy
+      - name: Install Node.js for WebUI bundle builds
+        if: contains(matrix.flags, '--all-features')
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: crates/ironclaw_webui_v2_static/frontend/package-lock.json
       - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2
         with:
           key: windows-${{ matrix.name }}

.github/workflows/platform-and-compat.yml

@@ -254,6 +254,12 @@ jobs:
         uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
         with:
           targets: wasm32-wasip2
+      - name: Install Node.js for WebUI bundle builds
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: crates/ironclaw_webui_v2_static/frontend/package-lock.json
       - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2
         with:
           key: wasm-extensions
@@ -286,6 +292,12 @@ jobs:
           persist-credentials: false
       - name: Install Rust
         uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
+      - name: Install Node.js for WebUI bundle builds
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: crates/ironclaw_webui_v2_static/frontend/package-lock.json
       - uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2
         with:
           key: bench

.github/workflows/reborn-e2e.yml

@@ -134,6 +134,13 @@ jobs:
       - name: Install Rust
         uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
 
+      - name: Install Node.js for WebUI bundle build
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: crates/ironclaw_webui_v2_static/frontend/package-lock.json
+
       - name: Restore Rust cache
         uses: Swatinem/rust-cache@e18b497796c12c097a38f9edb9d0641fb99eee32 # v2
         with:

.github/workflows/reborn-tests.yml

@@ -202,6 +202,27 @@ jobs:
       - name: Install Rust
         uses: dtolnay/rust-toolchain@29eef336d9b2848a0b548edc03f92a220660cdb8 # stable
 
+      - name: Resolve crate feature flags
+        id: crate-feature-flags
+        env:
+          PACKAGE: ${{ matrix.package }}
+        run: |
+          feature_flags="$(scripts/ci/package-feature-flags.sh "$PACKAGE")"
+          echo "feature_flags=${feature_flags}" >> "$GITHUB_OUTPUT"
+          if [[ "${feature_flags}" == *"webui-v2-beta"* ]]; then
+            echo "needs_webui_node=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "needs_webui_node=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Install Node.js for WebUI bundle builds
+        if: ${{ steps.crate-feature-flags.outputs.needs_webui_node == 'true' }}
+        uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 # v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: crates/ironclaw_webui_v2_static/frontend/package-lock.json
+
       - name: Install mold and clang
         run: |
           scripts/ci/install-ci-apt-packages.sh clang mold
@@ -227,7 +248,7 @@ jobs:
         env:
           PACKAGE: ${{ matrix.package }}
         run: |
-          feature_flags="$(scripts/ci/package-feature-flags.sh "$PACKAGE")"
+          feature_flags="${{ steps.crate-feature-flags.outputs.feature_flags }}"
 
           if [ "$PACKAGE" = "ironclaw_reborn_composition" ]; then
             echo "Disabling incremental compilation for ironclaw_reborn_composition to keep runner disk usage bounded."

.gitignore

@@ -62,6 +62,10 @@ trace_*.json
 # root they land in ./attachments/. These are user uploads, never source.
 /attachments/
 
+# Generated WebUI v2 bundle. Cargo builds and embeds this from OUT_DIR when
+# `webui-v2-beta` is enabled; the reviewable source lives under static/js/.
+/crates/ironclaw_webui_v2_static/static/dist/
+
 # Python cache
 __pycache__/
 *.pyc

Dockerfile.reborn

@@ -12,9 +12,18 @@
 #   Postgres-backed hosted storage, or hosted-single-tenant-volume for a
 #   Railway volume-backed single-tenant preview.
 
+FROM node:22.23.1-bookworm-slim@sha256:813a7480f28fdadac1f7f5c824bcdad435b5bc1322a5968bbbdef8d058f9dff4 AS node_toolchain
+
 FROM rust:1.92-bookworm AS chef
 
-RUN cargo install --locked cargo-chef@0.1.77
+COPY --from=node_toolchain /usr/local/bin/node /usr/local/bin/node
+COPY --from=node_toolchain /usr/local/lib/node_modules/ /usr/local/lib/node_modules/
+
+RUN ln -sf ../lib/node_modules/npm/bin/npm-cli.js /usr/local/bin/npm \
+    && ln -sf ../lib/node_modules/npm/bin/npx-cli.js /usr/local/bin/npx \
+    && node --version \
+    && npm --version \
+    && cargo install --locked cargo-chef@0.1.77
 
 WORKDIR /app
 

README.md

@@ -229,8 +229,10 @@ cargo run -q -p ironclaw_reborn_cli --bin ironclaw-reborn -- repl --confirm-host
 
 ### WebUI service
 
-The Reborn WebUI is compiled behind the `webui-v2-beta` Cargo feature. Build or
-run the binary with that feature to enable the `serve` command:
+The Reborn WebUI is compiled behind the `webui-v2-beta` Cargo feature. Builds
+with this feature require Node.js/npm so Cargo can generate and embed the SPA
+bundle. Build or run the binary with that feature to enable the `serve`
+command:
 
 ```bash
 cargo run -q -p ironclaw_reborn_cli --features webui-v2-beta --bin ironclaw-reborn -- serve --help
@@ -422,6 +424,7 @@ IronClaw is the AI assistant you can actually trust with your personal and profe
 
 - Rust 1.92+
 - PostgreSQL 15+ with [pgvector](https://github.com/pgvector/pgvector) extension
+- Node.js 22+ (npm) for source builds that enable the `webui-v2-beta` feature
 - NEAR AI account (authentication handled via setup wizard)
 - `libclang` and a working C toolchain if you build the WeChat voice/SILK path from source
 

crates/ironclaw_reborn_cli/AGENTS.md

@@ -44,6 +44,10 @@ cargo install --path crates/ironclaw_reborn_cli --features webui-v2-beta
 cargo build -p ironclaw_reborn_cli --features webui-v2-beta --release
 ```
 
+The beta WebUI static crate runs the frontend bundler from Cargo build scripts,
+so any `webui-v2-beta` or `--all-features` build needs Node.js/npm available
+even though the generated `static/dist/` bundle is not committed.
+
 When the feature is off, `ironclaw-reborn --help` does not list `serve`
 and `ironclaw-reborn serve …` returns `error: unrecognized subcommand`.
 This is verified by `help_mentions_reborn_commands` in `tests/smoke.rs`,