feat(web): add test server utilities and configuration files

- Introduced `test-server.ts` for creating isolated test environments for API integration testing.
- Added `tsconfig.json` for TypeScript configuration specific to the web package.
- Created `vercel.json` for production environment variables.
- Implemented `vitest.config.ts` for testing setup and configuration.
- Updated `pnpm-lock.yaml` to include dependencies for the web package.
- Modified `pnpm-workspace.yaml` to remove the apps directory from workspace packages.
- Adjusted validation scripts to reference the new packages/web directory structure.

Author: tikazyq

.github/scripts/README.md

@@ -15,79 +15,103 @@ This directory contains reusable shell scripts to optimize and simplify GitHub A
 ### Core Build & Test Scripts
 
 #### `setup-node.sh`
+
 Sets up Node.js environment and installs dependencies with pnpm.
+
 ```bash
 ./.github/scripts/setup-node.sh [node_version] [pnpm_version]
 ```
+
 - **Default**: Node.js 20, pnpm 10.15.0
 - **Used in**: All workflows that need Node.js
 
 #### `build-packages.sh`
+
 Builds all packages in dependency order (core → ai → mcp → web).
+
 ```bash
 ./.github/scripts/build-packages.sh
 ```
+
 - **Dependencies**: Requires pnpm workspace setup
-- **Output**: Build artifacts in `packages/*/build` and `apps/web/.next-build`
+- **Output**: Build artifacts in `packages/*/build` and `packages/web/.next-build`
 
 #### `verify-build.sh`
+
 Verifies that all expected build artifacts exist.
+
 ```bash
 ./.github/scripts/verify-build.sh
 ```
-- **Checks**: 
+
+- **Checks**:
   - Core, AI, MCP, CLI packages: `build/index.js` and `build/index.d.ts`
   - Web package: `.next-build/` directory
 - **Exit codes**: 0 = success, 1 = missing artifacts
 
 #### `run-tests.sh`
+
 Runs tests for all packages with coverage.
+
 ```bash
 ./.github/scripts/run-tests.sh
 ```
+
 - **Command**: `pnpm -r test:coverage`
 - **Requirements**: All packages must have `test:coverage` script
 
 ### NPM Publishing Scripts
 
 #### `check-versions.sh`
+
 Determines which packages need to be published based on version comparison.
+
 ```bash
 ./.github/scripts/check-versions.sh [force_publish] [package_filter]
 ```
+
 - **Parameters**:
   - `force_publish`: "true" to force publish regardless of versions
   - `package_filter`: Comma-separated list (e.g., "core,mcp")
 - **Output**: Sets GitHub Actions outputs for downstream jobs
 - **Environment**: Requires `NODE_AUTH_TOKEN` for NPM registry access
 
 #### `publish-packages.sh`
+
 Publishes specified packages to NPM registry.
+
 ```bash
 ./.github/scripts/publish-packages.sh "mcp,core,ai"
 ```
+
 - **Input**: Comma-separated package list
 - **Environment**: Requires `NODE_AUTH_TOKEN`
 - **Output**: Sets `published_packages` GitHub Actions output
 
 ### Docker & Validation Scripts
 
 #### `test-docker.sh`
+
 Tests Docker image functionality by starting container and checking endpoints.
+
 ```bash
 ./.github/scripts/test-docker.sh "image:tag"
 ```
+
 - **Tests**:
   - Container starts successfully
   - HTTP endpoint responds (port 3000)
   - Health check endpoint (if available)
 - **Cleanup**: Automatically stops test container
 
 #### `validate-pr.sh`
+
 Runs lightweight validation checks for pull requests.
+
 ```bash
 ./.github/scripts/validate-pr.sh
 ```
+
 - **Checks**:
   - TypeScript compilation
   - Quick build test (core, ai, mcp packages)
@@ -97,6 +121,7 @@ Runs lightweight validation checks for pull requests.
 ## 🔧 Usage in Workflows
 
 ### Before (Workflow with inline scripts)
+
 ```yaml
 - name: Build packages
   run: |
@@ -107,6 +132,7 @@ Runs lightweight validation checks for pull requests.
 ```
 
 ### After (Workflow with script)
+
 ```yaml
 - name: Build packages
   run: ./.github/scripts/build-packages.sh
@@ -132,48 +158,55 @@ All scripts can be tested locally:
 ## 🔍 Script Standards
 
 ### Error Handling
+
 - All scripts use `set -euo pipefail` for strict error handling
 - Exit codes: 0 = success, 1 = failure
 - Clear error messages with emojis for visibility
 
 ### GitHub Actions Integration
+
 - Scripts write to `$GITHUB_OUTPUT` when available
 - Fallback to stdout for local testing
 - Support both CI and local environments
 
 ### Logging
+
 - Consistent emoji prefixes for different operations:
   - 🔧 Setup/configuration
   - 🔨 Building
-  - 🧪 Testing  
+  - 🧪 Testing
   - 📦 Packaging/publishing
   - 🐳 Docker operations
   - ✅ Success
   - ❌ Failure
   - ⚠️ Warning
 
 ### Parameters
+
 - Support both required and optional parameters
 - Provide sensible defaults
 - Document parameter usage in script comments
 
 ## 📊 Performance Impact
 
 ### Before Refactoring
+
 - **Duplicated logic**: ~150 lines across 3 workflows
 - **Maintenance**: Changes needed in multiple files
 - **Testing**: Difficult to test workflow logic locally
 
-### After Refactoring  
+### After Refactoring
+
 - **Centralized logic**: ~50 lines per workflow (70% reduction)
 - **Maintenance**: Changes in single script files
 - **Testing**: Scripts testable locally and in CI
 
 ## 🚀 Future Enhancements
 
 Potential improvements:
+
 - **Script parameters**: More configurable options
 - **Parallel execution**: Where safe and beneficial
-- **Advanced caching**: More granular cache strategies  
+- **Advanced caching**: More granular cache strategies
 - **Integration testing**: End-to-end workflow testing
 - **Monitoring**: Script execution metrics

.github/scripts/verify-build.sh

@@ -31,7 +31,7 @@ else
 fi
 
 # Check web package
-if [ -d "apps/web/.next" ]; then
+if [ -d "packages/web/.next" ]; then
     echo "✅ Web package build artifacts verified"
 else
     echo "❌ Web package build artifacts missing"

.github/workflows/main.yml

@@ -77,7 +77,7 @@ jobs:
         with:
           path: |
             packages/*/build
-            apps/web/.next-build
+            packages/web/.next-build
           key: build-${{ github.sha }}-${{ matrix.node-version }}
 
       - name: Verify build artifacts
@@ -191,7 +191,7 @@ jobs:
         with:
           path: |
             packages/*/build
-            apps/web/.next-build
+            packages/web/.next-build
           key: build-${{ github.sha }}-20
 
       - name: Check versions and determine what to publish
@@ -275,7 +275,7 @@ jobs:
         with:
           path: |
             packages/*/build
-            apps/web/.next-build
+            packages/web/.next-build
           key: build-${{ github.sha }}-20
 
       - name: Bump to dev prerelease versions

Dockerfile

@@ -25,7 +25,7 @@ FROM base AS deps
 # Copy package.json files for proper dependency resolution
 COPY packages/core/package.json ./packages/core/
 COPY packages/ai/package.json ./packages/ai/
-COPY apps/web/package.json ./apps/web/
+COPY packages/web/package.json ./packages/web/
 
 # Install dependencies
 RUN --mount=type=cache,id=pnpm,target=/pnpm/store pnpm install --frozen-lockfile
@@ -39,12 +39,12 @@ FROM base AS builder
 COPY --from=deps /app/node_modules ./node_modules
 COPY --from=deps /app/packages/core/node_modules ./packages/core/node_modules
 COPY --from=deps /app/packages/ai/node_modules ./packages/ai/node_modules
-COPY --from=deps /app/apps/web/node_modules ./apps/web/node_modules
+COPY --from=deps /app/packages/web/node_modules ./packages/web/node_modules
 
 # Copy source code (excluding MCP package)
 COPY packages/core ./packages/core
 COPY packages/ai ./packages/ai
-COPY apps/web ./apps/web
+COPY packages/web ./packages/web
 COPY tsconfig.json ./
 COPY vitest.config.base.ts ./
 
@@ -75,12 +75,12 @@ RUN addgroup --system --gid 1001 nodejs
 RUN adduser --system --uid 1001 nextjs
 
 # Copy the standalone build output and static files
-COPY --from=builder /app/apps/web/.next-build/standalone ./
-COPY --from=builder /app/apps/web/.next-build/static ./apps/web/.next-build/static
-COPY --from=builder /app/apps/web/public ./apps/web/public
+COPY --from=builder /app/packages/web/.next-build/standalone ./
+COPY --from=builder /app/packages/web/.next-build/static ./packages/web/.next-build/static
+COPY --from=builder /app/packages/web/public ./packages/web/public
 
 # Create directories that the application might need and set permissions
-RUN mkdir -p /app/apps/web/.devlog /app/.devlog && \
+RUN mkdir -p /app/packages/web/.devlog /app/.devlog && \
     chown -R nextjs:nodejs /app
 
 # Set correct permissions
@@ -93,4 +93,4 @@ HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
   CMD node -e "require('http').get('http://localhost:3000/api/health', (res) => { process.exit(res.statusCode === 200 ? 0 : 1) }).on('error', () => process.exit(1))"
 
 # Start the Next.js application using the standalone server
-CMD ["node", "apps/web/server.js"]
+CMD ["node", "packages/web/server.js"]

Dockerfile.dev

@@ -18,7 +18,7 @@ COPY pnpm-workspace.yaml package.json pnpm-lock.yaml ./
 # Copy package files for web application dependencies only
 COPY packages/ai/package.json ./packages/ai/
 COPY packages/core/package.json ./packages/core/
-COPY apps/web/package.json ./apps/web/
+COPY packages/web/package.json ./packages/web/
 
 # Install dependencies
 RUN --mount=type=cache,id=pnpm,target=/pnpm/store pnpm install