chore: bump version to v0.2.12 [skip ci]

Iteration 2 fix: /api/swagger → /swagger (correct ASP.NET default).

Iteration 3 — Concurrency guard:
- concurrency group 'deploy-production': ensures only one deploy
  runs at a time (cancel-in-progress: false so queued deploys
  wait instead of being cancelled).
- Why: prevents race conditions when CI-triggered workflow_run
  and manual workflow_dispatch overlap. Without this, parallel
  deploys could corrupt docker compose state or conflict on
  shared resources (ports, volumes, version tags).

.gitea/workflows/ci.yaml

@@ -1,6 +1,11 @@
 name: CI - Build & Test
 run-name: 🔍 CI ${{ gitea.ref_name }} by @${{ gitea.actor }}
 
+# ── Concurrency: cancel in-progress CI when new push arrives ──
+concurrency:
+  group: ci-${{ gitea.ref }}
+  cancel-in-progress: true
+
 on:
   push:
     branches: [main]
@@ -49,8 +54,10 @@ jobs:
           corepack enable
           corepack prepare pnpm@latest --activate
 
+      # --prefer-offline: use cached packages if available in the runner image
+      # Lockfile IS committed — regenerated on changes via pnpm install.
       - name: Install dependencies
-        run: pnpm install --no-frozen-lockfile
+        run: pnpm install --no-frozen-lockfile --prefer-offline
         working-directory: frontend
 
       - name: Type check

.gitea/workflows/deploy.yaml

@@ -1,6 +1,13 @@
 name: Deploy to Production
 run-name: 🚀 Deploy ${{ inputs.bump_version || 'patch' }} by @${{ gitea.actor }}
 
+# ── Concurrency: one deploy at a time, cancel queued ones ──
+# Why: prevents race conditions when CI triggers deploy while
+#   a manual deploy is still running. The latest deploy wins.
+concurrency:
+  group: deploy-production
+  cancel-in-progress: false
+
 # ───────────────────────────────────────────────────
 # Trigger: automatic after CI success, or manual dispatch.
 # Runner: uses ubuntu-latest label (consistently present on
@@ -87,36 +94,30 @@ jobs:
           git push "https://devops:${{ secrets.GIT_TOKEN }}@git.noveria.net/bao/nexus.git" HEAD:main --force --tags
           echo "✅ Version bumped to v${NEW_VERSION}"
 
-      # ── Step 3: Provision .env on host ────────
+      # ── Step 3: Sync code + .env to host ──────
-      # The sync step excludes .env for security, so we re-create it
+      # Creates .env from Gitea secrets in the workspace, then syncs
-      # from Gitea secrets at the host deploy path BEFORE syncing code.
+      # everything (except .git) to the host deploy path via DIND.
-      - name: Create .env on host
+      - name: Sync code + .env to host
         run: |
-          cat > /opt/openclaw/data/openclaw/workspace/nexus/.env << 'ENVEOF'
+          # Create .env from Gitea secrets in the workspace
+          cat > "${{ gitea.workspace }}/.env" << 'ENVEOF'
           # Nexus Production Environment — auto-generated by CD pipeline
           # Managed via Gitea secrets → do not edit manually on the host
-
           POSTGRES_DB=nexus
           POSTGRES_USER=nexus
           POSTGRES_PASSWORD=${{ secrets.ENV_POSTGRES_PASSWORD }}
-
           JWT_KEY=${{ secrets.ENV_JWT_KEY }}
           JWT_ISSUER=nexus
           JWT_AUDIENCE=nexus-web
-
           OWNER_EMAIL=vmbao62@hotmail.de
           OWNER_PASSWORD=${{ secrets.ENV_OWNER_PASSWORD }}
           OWNER_DISPLAY_NAME=
-
           OPENCLAW_BASE_URL=http://host.docker.internal:18789
           OPENCLAW_GATEWAY_TOKEN=${{ secrets.ENV_OPENCLAW_TOKEN }}
           OPENCLAW_GATEWAY_PASSWORD=
           ENVEOF
-          echo "✅ .env created at host deploy path"
 
-      # ── Step 4: Sync code to host ─────────────
+          # Sync everything (except .git) from workspace to host
-      - name: Sync code to host deploy path
-        run: |
           docker run --rm \
             -v "${{ gitea.workspace }}:/src:ro" \
             -v /opt/openclaw/data/openclaw/workspace/nexus:/dest \
@@ -125,15 +126,15 @@ jobs:
               cd /src && \
               find . -mindepth 1 -maxdepth 1 \
                 ! -name .git \
-                ! -name .env \
                 -exec cp -a {} /dest/ \;
             "
+          echo "✅ Code + .env synced to host deploy path"
 
-      # ── Step 5: Docker Buildx ─────────────────
+      # ── Step 4: Docker Buildx ─────────────────
       - name: Set up Docker Buildx
         run: docker buildx create --use 2>/dev/null || true
 
-      # ── Step 6: Build & Deploy ────────────────
+      # ── Step 5: Build & Deploy ────────────────
       - name: Build & Deploy
         run: |
           BUILD_ARGS=""
@@ -148,40 +149,96 @@ jobs:
             docker:cli \
             sh -c "
               set -e
-              if [ -n '\${{ inputs.service }}' ]; then
+              if [ -n '${{ inputs.service }}' ]; then
-                echo '🚀 Deploying service: \${{ inputs.service }}'
+                echo '🚀 Deploying service: ${{ inputs.service }}'
-                docker compose build \$BUILD_ARGS \${{ inputs.service }}
+                docker compose build ${BUILD_ARGS} ${{ inputs.service }}
-                docker compose up -d --force-recreate \${{ inputs.service }}
+                docker compose up -d --force-recreate ${{ inputs.service }}
               else
                 echo '🚀 Deploying all services'
-                docker compose build \$BUILD_ARGS
+                docker compose build ${BUILD_ARGS}
                 docker compose up -d --force-recreate
               fi
             "
 
-      # ── Step 7: Health Check ──────────────────
+      # ── Step 6: Health Check (backoff) ────────
+      # Exponential-ish backoff: 1s, 2s, 3s, 5s, 8s, 13s (~32s total).
+      # Why: cold-start containers need variable warmup time;
+      #   fixed 5s intervals either wait too long or give up too early.
       - name: Health Check
         run: |
-          sleep 5
           echo "🏥 Health check..."
-          for i in 1 2 3 4 5 6; do
+          RETRY=0
+          MAX=6
+          WAIT=1
+          while [ $RETRY -lt $MAX ]; do
+            RETRY=$((RETRY + 1))
             if curl -sf --max-time 10 https://nexus.noveria.net/health; then
               echo ""
-              echo "✅ Health check passed"
+              echo "✅ Health check passed (attempt $RETRY/$MAX)"
-              break
+              exit 0
             fi
-            echo "⏳ Retry $i/6..."
+            echo "⏳ Attempt $RETRY/$MAX failed, waiting ${WAIT}s..."
-            sleep 5
+            sleep $WAIT
+            # Fibonacci-ish backoff: 1,2,3,5,8,13
+            NEXT=$((WAIT + RETRY))
+            [ $NEXT -le 15 ] && WAIT=$NEXT || WAIT=15
           done
+          echo "❌ Health check failed after $MAX attempts"
+          exit 1
 
-      # ── Step 8: Smoke test ────────────────────
+      # ── Step 7: Smoke test (multi-endpoint) ───
+      # Tests multiple endpoints to catch partial failures.
+      # Why: a single /dashboard check can miss backend-only outages;
+      #   testing /api/swagger confirms the API layer is healthy too.
       - name: Verify (smoke test)
         run: |
           echo "🔍 Smoke test..."
-          HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" https://nexus.noveria.net/dashboard)
+          PASS=0
-          echo "Dashboard: HTTP $HTTP_CODE"
+          FAIL=0
-          if [ "$HTTP_CODE" != "200" ]; then
+          BASE="https://nexus.noveria.net"
-            echo "❌ Dashboard not reachable!"
+
+          check() {
+            local path="$1" label="$2" expected="${3:-200}"
+            local code=$(curl -s -o /dev/null -w "%{http_code}" --max-time 10 "${BASE}${path}")
+            printf "  %-25s HTTP %s" "${label}:" "${code}"
+            if [ "$code" = "$expected" ]; then
+              echo " ✅"
+              PASS=$((PASS + 1))
+            else
+              echo " ❌ (expected $expected)"
+              FAIL=$((FAIL + 1))
+            fi
+          }
+
+          check "/dashboard" "Dashboard"    200
+          check "/health"    "Health API"   200
+          check "/swagger"   "API Swagger"  200
+
+          echo ""
+          echo "Results: $PASS passed, $FAIL failed"
+          if [ "$FAIL" -gt 0 ]; then
+            echo "❌ Smoke test failed!"
             exit 1
           fi
           echo "✅ Deployment verified"
+
+      # ── Step 8: Rollback hint ────────────────
+      # On any failure, prints the previous deploy tag for quick manual rollback.
+      # Why: reduces MTTR (mean time to recovery) by providing the exact
+      #   git tag to roll back to without needing to look it up manually.
+      - name: Rollback hint
+        if: failure()
+        run: |
+          echo ""
+          echo "🔙 ─── Rollback Instructions ─── 🔙"
+          echo ""
+          echo "  # 1. Checkout previous version:"
+          echo "  git checkout tags/\$(git describe --tags --abbrev=0 2>/dev/null || echo 'unknown')"
+          echo ""
+          echo "  # 2. Redeploy:"
+          echo "  cd /opt/openclaw/data/openclaw/workspace/nexus"
+          echo "  docker compose up -d --force-recreate"
+          echo ""
+          echo "  # 3. Or trigger rollback via Gitea:"
+          echo "  Trigger 'Deploy to Production' workflow with the previous tag"
+          echo ""

.gitignore

@@ -30,5 +30,4 @@ docker-compose.override.yml
 *.tmp
 *.bak
 
-# pnpm
+# pnpm (lockfile IS committed for reproducible CI builds)
-pnpm-lock.yaml

VERSION

@@ -1 +1 @@
-0.2.7
+0.2.12