Merge branch 'main' into wegent/team-icon-favorites-showcase

Author: qdaxb

.githooks/pre-push

@@ -0,0 +1,29 @@
+#!/bin/bash
+# =============================================================================
+# Pre-push Hook - AI Code Quality Check
+# =============================================================================
+# This hook runs quality checks before push for AI coding agents.
+# It directly calls the ai-push-gate.sh script without requiring pre-commit.
+#
+# Usage:
+#   git push                    (runs all checks)
+#   AI_VERIFIED=1 git push      (skip doc reminders after review)
+#   git push --no-verify        (skip all checks - not recommended)
+# =============================================================================
+
+# Get the directory where this script is located
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Change to project root
+cd "$PROJECT_ROOT"
+
+# Run the AI push gate script
+if [ -f "scripts/hooks/ai-push-gate.sh" ]; then
+    bash scripts/hooks/ai-push-gate.sh
+    exit $?
+fi
+
+# If the script doesn't exist, just pass
+echo "⚠️ scripts/hooks/ai-push-gate.sh not found, skipping checks."
+exit 0

.github/workflows/e2e-tests.yml

@@ -0,0 +1,156 @@
+name: E2E Tests
+
+on:
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+env:
+  # Next.js rewrites /api/* to ${NEXT_PUBLIC_API_URL}/api/*, so only set the base URL
+  NEXT_PUBLIC_API_URL: http://localhost:8000
+  # Use pymysql driver (installed via requirements.txt)
+  DATABASE_URL: mysql+pymysql://root:123456@localhost:3306/task_manager
+  REDIS_URL: redis://localhost:6379
+  ENVIRONMENT: development
+  # Enable auto migration on backend startup
+  DB_AUTO_MIGRATE: 'True'
+
+jobs:
+  e2e-tests:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: '123456'
+          MYSQL_DATABASE: task_manager
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h localhost"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+
+      redis:
+        image: redis:7
+        ports:
+          - 6379:6379
+        options: >-
+          --health-cmd="redis-cli ping"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+          cache: 'pip'
+          cache-dependency-path: backend/requirements.txt
+
+      - name: Install backend dependencies
+        working-directory: backend
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install frontend dependencies
+        working-directory: frontend
+        run: npm ci
+
+      - name: Build frontend
+        working-directory: frontend
+        env:
+          # Next.js rewrites /api/* to ${NEXT_PUBLIC_API_URL}/api/*, so only set the base URL
+          NEXT_PUBLIC_API_URL: http://localhost:8000
+        run: npm run build
+
+      - name: Install Playwright browsers
+        working-directory: frontend
+        run: npx playwright install chromium --with-deps
+
+      - name: Start backend server
+        working-directory: backend
+        env:
+          DATABASE_URL: mysql+pymysql://root:[email protected]:3306/task_manager
+          REDIS_URL: redis://127.0.0.1:6379
+          ENVIRONMENT: development
+          DB_AUTO_MIGRATE: 'True'
+          INIT_DATA_ENABLED: 'True'
+          INIT_DATA_DIR: ${{ github.workspace }}/backend/init_data
+          # Add project root to PYTHONPATH so 'shared' module can be imported
+          PYTHONPATH: ${{ github.workspace }}
+        run: |
+          uvicorn app.main:app --host 0.0.0.0 --port 8000 &
+          echo "Backend server starting (with auto migration and YAML init enabled)..."
+
+      - name: Start frontend server
+        working-directory: frontend
+        env:
+          # Next.js rewrites /api/* to ${NEXT_PUBLIC_API_URL}/api/*, so only set the base URL
+          NEXT_PUBLIC_API_URL: http://localhost:8000
+        run: |
+          npm start &
+          echo "Frontend server starting..."
+
+      - name: Wait for services to be ready
+        run: |
+          echo "Waiting for backend..."
+          for i in {1..60}; do
+            if curl -s http://localhost:8000/api/health > /dev/null 2>&1 || curl -s http://localhost:8000/ > /dev/null 2>&1; then
+              echo "Backend is ready!"
+              break
+            fi
+            echo "Waiting for backend... ($i/60)"
+            sleep 2
+          done
+
+          echo "Waiting for frontend..."
+          for i in {1..30}; do
+            if curl -s http://localhost:3000 > /dev/null 2>&1; then
+              echo "Frontend is ready!"
+              break
+            fi
+            echo "Waiting for frontend... ($i/30)"
+            sleep 2
+          done
+
+      - name: Run E2E tests
+        working-directory: frontend
+        env:
+          E2E_BASE_URL: http://localhost:3000
+          CI: true
+        run: npm run e2e
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: e2e-test-results
+          path: |
+            frontend/e2e-results.json
+            frontend/playwright-report/
+            frontend/test-results/
+          retention-days: 7
+
+      - name: Upload failure screenshots
+        uses: actions/upload-artifact@v4
+        if: failure()
+        with:
+          name: e2e-failure-screenshots
+          path: frontend/test-results/**/*.png
+          retention-days: 7

AGENTS.md

@@ -311,6 +311,77 @@ const form = useForm({ resolver: zodResolver(schema) })
 
 ## 🔄 Git Workflow
 
+### AI Code Quality Check (Pre-push)
+
+Wegent uses git hooks to ensure code quality for AI coding agents (Claude Code, Cursor, etc.). All quality checks run **before push**, allowing multiple commits locally without interruption.
+
+**Auto-enabled in Executor:**
+When the executor clones a repository, git hooks are automatically configured via `core.hooksPath=.githooks`. No manual installation required.
+
+**Local Development (via npm install):**
+```bash
+cd frontend && npm install  # Husky automatically configures pre-push hook
+```
+
+**Manual Installation (alternative):**
+```bash
+# Configure git to use .githooks directory
+git config core.hooksPath .githooks
+```
+
+**Usage:**
+
+```bash
+# Normal workflow - checks run automatically before push
+git add .
+git commit -m "feat: your feature"
+git push  # <- Quality checks run here
+
+# If documentation reminders shown, verify and push
+AI_VERIFIED=1 git push
+
+# Skip all checks (not recommended)
+git push --no-verify
+```
+
+**Quality Checks:**
+
+| Check | Tools | Scope |
+|-------|-------|-------|
+| Doc Reminders | Custom script | API, Schema changes |
+
+**Manual Commands:**
+```bash
+# Run checks manually
+bash scripts/hooks/ai-push-gate.sh
+
+# Skip all checks (not recommended)
+git push --no-verify
+```
+
+**Check Output Example:**
+```
+══════════════════════════════════════════════════════════
+📋 AI Code Quality Check Report (Pre-push)
+══════════════════════════════════════════════════════════
+
+📁 Files to be pushed:
+   Total: 6 file(s)
+   Modules affected:
+   - Backend: 3 file(s)
+   - Frontend: 2 file(s)
+
+✅ Lint & Format: PASSED
+✅ Type Check: PASSED
+✅ Unit Tests: PASSED (backend: 42 passed)
+✅ Build Check: PASSED
+
+⚠️ Documentation Reminders:
+   - backend/app/api/ changed → Check docs/ for updates
+
+══════════════════════════════════════════════════════════
+```
+
 ### Branch Naming
 
 **Pattern:** `<type>/<description>`
@@ -611,3 +682,4 @@ docker-compose up -d --build [service]
 **Last Updated**: 2025-07
 **Wegent Version**: 1.0.8
 **Maintained by**: WeCode-AI Team
+

CONTRIBUTING.md

@@ -153,10 +153,55 @@ git checkout -b feature/your-feature-name
 ```bash
 git add .
 git commit -m "feat: add new feature description"
+```
+
+### 4. Push Code (Quality Checks Run Here)
+
+#### Pre-push Setup (Required)
+
+Wegent uses pre-commit hooks to ensure code quality before pushing. This is especially important for AI coding agents (Claude Code, Cursor, etc.).
+
+```bash
+# Install pre-commit
+pip install pre-commit
+
+# Install pre-push hooks
+pre-commit install --hook-type pre-push
+```
+
+#### Pre-push Quality Checks
+
+When pushing code, pre-commit automatically runs quality checks:
+
+- Lint & Format (Black, isort, ESLint)
+- Type Check (TypeScript, mypy)
+- Unit Tests (only for changed modules)
+- Build Check (syntax validation)
+- Documentation update reminders
+
+```bash
+# Push to remote (triggers quality checks)
 git push origin feature/your-feature-name
+
+# If documentation reminders shown, verify and push
+AI_VERIFIED=1 git push origin feature/your-feature-name
+
+# Skip checks if needed (not recommended)
+git push --no-verify origin feature/your-feature-name
+```
+
+#### Manual Quality Checks
+
+```bash
+# Run all pre-push checks manually
+pre-commit run --all-files --hook-stage pre-push
+
+# Run specific checks
+pre-commit run black --all-files
+pre-commit run eslint-frontend --all-files
 ```
 
-### 4. Create Pull Request
+### 5. Create Pull Request
 
 - Fill out complete PR description
 - Link related issues

frontend/.gitignore

@@ -3,3 +3,9 @@
 # SPDX-License-Identifier: Apache-2.0
 
 .next/
+
+# Playwright
+e2e/.auth/
+playwright-report/
+test-results/
+e2e-results.json

frontend/.husky/pre-push

@@ -0,0 +1,15 @@
+#!/usr/bin/env sh
+
+# Navigate to project root
+PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+cd "$PROJECT_ROOT" || exit 1
+
+# Run AI push gate script
+if [ -f "scripts/hooks/ai-push-gate.sh" ]; then
+    bash scripts/hooks/ai-push-gate.sh
+    exit $?
+fi
+
+# If script doesn't exist, just pass
+echo "⚠️ scripts/hooks/ai-push-gate.sh not found, skipping checks."
+exit 0