Merge pull request #2464 from goplus/dev

Release v1.11.8

Author: nighca

.github/agents/spx-upgrader.md

@@ -0,0 +1,18 @@
+---
+name: spx-upgrader
+description: Keeps every spx reference in goplus/builder aligned with the requested release
+---
+
+You are a release specialist dedicated to upgrading spx across goplus/builder safely and consistently. Your responsibilities:
+
+- Require the requester to specify the target spx version, and stop immediately with an error message if it is missing
+- Parse the requested spx version and verify it exists by running `gh release view --repo goplus/spx v<version>`
+- Update `spx-gui/.env` and `spx-gui/install-spx.sh` so `VITE_SPX_VERSION` and `SPX_VERSION` match the target
+- Refresh Go modules in `tools/ai/` and `tools/spxls/` via `go get github.com/goplus/spx/v2@v<version>` followed by `go mod tidy`
+- Execute `bash spx-gui/install-spx.sh` to download the matching `spx_web.zip` and remove any temporary archives
+- Execute `bash build-wasm.sh` in `spx-gui/` to build Wasm components
+- Run `npm ci`, `npm run lint`, `npm run test -- --run` in `spx-gui/`, plus `go test ./...` inside `tools/ai/` and `tools/spxls/`
+- Verify `git status` is clean beyond the expected files, then create a commit titled `chore(deps): bump spx to <version>` and draft a PR with release notes and validation logs
+- If any command fails, stop immediately and report the exact output instead of continuing
+
+Always ensure every file referencing spx (env, install script, Go modules, generated assets) reflects the same version before requesting review.

.github/workflows/publish-docker-image.yml

@@ -1,14 +1,15 @@
 name: Publish Docker image
 on:
   push:
-    branches:
-      - dev
+  pull_request:
 jobs:
   publish-docker-image:
     runs-on: ubuntu-latest
     steps:
       - name: Check out code
         uses: actions/checkout@v5
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
       - name: Configure spx-gui to use co-located spx-backend
         run: echo "VITE_API_BASE_URL=/api" > ./spx-gui/.env.staging.local
       - name: Log in to GitHub Container Registry
@@ -23,6 +24,8 @@ jobs:
           context: .
           build-args: |
             NODE_ENV=staging
-          push: true
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          push: ${{ github.event_name == 'push' && github.ref_name == 'dev' }}
           tags: |
             ghcr.io/${{github.repository}}:dev

.github/workflows/validate.yml

@@ -7,9 +7,22 @@ on:
 jobs:
   spx-gui-lint:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: spx-gui
     steps:
       - uses: actions/checkout@v5
 
+      - name: Cache Node modules
+        uses: actions/cache@v4
+        env:
+          cache-name: cache-node-modules
+        with:
+          path: spx-gui/node_modules
+          key: ${{runner.os}}-${{runner.arch}}-${{env.cache-name}}-${{hashFiles('spx-gui/package-lock.json')}}
+          restore-keys: |
+            ${{runner.os}}-${{runner.arch}}-${{env.cache-name}}-
+
       - name: Enable Corepack
         run: corepack enable
 
@@ -20,68 +33,82 @@ jobs:
           cache: npm
           cache-dependency-path: spx-gui/package-lock.json
 
-      - name: Install modules
-        working-directory: spx-gui
-        run: npm install
+      - name: Install Node modules
+        run: npm install --prefer-offline
 
       - name: Install spx
-        working-directory: spx-gui
         run: ./install-spx.sh
 
       - name: Run Vue TSC
-        working-directory: spx-gui
         run: npm run type-check
 
       - name: Run ESLint
-        working-directory: spx-gui
         run: npm run lint
 
       - name: Run format check
-        working-directory: spx-gui
         run: npm run format-check
 
       - name: Setup Go
         uses: actions/setup-go@v6
         with:
           go-version: 1.24.x
+          cache: true
+          cache-dependency-path: |
+            tools/spxls/go.sum
+            tools/ai/go.sum
 
       - name: Build WASM
-        working-directory: spx-gui
         run: ./build-wasm.sh
 
       - name: Run Vitest
-        working-directory: spx-gui
         run: npm run test
 
       - name: Build
-        working-directory: spx-gui
         run: npm run build
 
   spx-backend-test:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: spx-backend
     steps:
       - uses: actions/checkout@v5
 
-      - name: Set up Go & XGo
-        uses: goplus/setup-xgo@v1
+      - name: Setup Go
+        uses: actions/setup-go@v6
         with:
           go-version: 1.24.x
+          cache: true
+          cache-dependency-path: spx-backend/go.sum
+
+      - name: Set up XGo
+        uses: goplus/setup-xgo@v1
+        with:
           xgo-version: 1.5.x
 
+      - name: Ensure xgo mod tidy is clean
+        working-directory: spx-backend/cmd/spx-backend
+        run: |
+          xgo mod tidy
+          git diff --exit-code
+
       - name: Run unit test cases
-        working-directory: spx-backend
         run: go test -v -race ./...
 
   tools-ai-test:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: tools/ai
     steps:
       - uses: actions/checkout@v5
 
       - name: Setup Go
         uses: actions/setup-go@v6
         with:
           go-version: 1.24.x
+          cache: true
+          cache-dependency-path: tools/ai/go.sum
 
       - name: Run unit test cases
-        working-directory: tools/ai
         run: go test -v -race ./...

Dockerfile

@@ -66,6 +66,9 @@ COPY --from=xgo-builder /app/spx-backend/spx-backend /app/spx-backend/spx-backen
 COPY --from=frontend-builder /app/spx-gui/dist /usr/share/nginx/html
 COPY scripts/nginx.conf /etc/nginx/conf.d/default.conf
 
+# Validate Nginx configuration
+RUN nginx -t
+
 # Compress WASM files for gzip_static
 RUN find /usr/share/nginx/html -name "*.wasm" -exec gzip -9 -k {} \;