@mandujs/cli 0.16.0 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",

package/src/commands/init.ts

@@ -17,6 +17,7 @@ export interface InitOptions {
   ui?: UILibrary;
   theme?: boolean;
   minimal?: boolean;
+  withCi?: boolean;
 }
 
 const ALLOWED_TEMPLATES = ["default", "realtime-chat"] as const;
@@ -214,6 +215,7 @@ export async function init(options: InitOptions = {}): Promise<boolean> {
   const css: CSSFramework = options.minimal ? "none" : (options.css || "tailwind");
   const ui: UILibrary = options.minimal ? "none" : (options.ui || "shadcn");
   const theme = options.theme || false;
+  const withCi = options.withCi || false;
 
   console.log(`🥟 Mandu Init`);
   console.log(`📁 프로젝트: ${projectName}`);
@@ -223,6 +225,9 @@ export async function init(options: InitOptions = {}): Promise<boolean> {
   if (theme) {
     console.log(`🌙 테마: Dark mode 지원`);
   }
+  if (withCi) {
+    console.log(`🔄 CI/CD: GitHub Actions 워크플로우 포함`);
+  }
   console.log();
 
   // Check if target directory exists
@@ -269,6 +274,11 @@ export async function init(options: InitOptions = {}): Promise<boolean> {
   // Create .mandu directory for build output
   await fs.mkdir(path.join(targetDir, ".mandu/client"), { recursive: true });
 
+  // Setup CI/CD workflows if requested
+  if (withCi) {
+    await setupCiWorkflows(targetDir);
+  }
+
   // Create minimal layout.tsx if css=none (without globals.css import)
   if (css === "none") {
     await createMinimalLayout(targetDir, projectName);
@@ -630,3 +640,37 @@ async function setupLockfile(targetDir: string): Promise<LockfileResult> {
     };
   }
 }
+
+/**
+ * CI/CD 워크플로우 파일 생성 (.github/workflows)
+ */
+async function setupCiWorkflows(targetDir: string): Promise<void> {
+  const workflowsDir = path.join(targetDir, ".github/workflows");
+  await fs.mkdir(workflowsDir, { recursive: true });
+
+  const templatesDir = getTemplatesDir();
+  const sourceWorkflowsDir = path.join(templatesDir, "default/.github/workflows");
+
+  try {
+    // Copy all workflow files
+    const workflowFiles = await fs.readdir(sourceWorkflowsDir);
+    for (const file of workflowFiles) {
+      const src = path.join(sourceWorkflowsDir, file);
+      const dest = path.join(workflowsDir, file);
+      const content = await fs.readFile(src, "utf-8");
+      await fs.writeFile(dest, content);
+    }
+
+    // Copy impact analysis script
+    const scriptsDir = path.join(targetDir, "scripts");
+    await fs.mkdir(scriptsDir, { recursive: true });
+
+    const analyzeImpactSrc = path.join(templatesDir, "default/scripts/analyze-impact.ts");
+    const analyzeImpactDest = path.join(scriptsDir, "analyze-impact.ts");
+    const analyzeImpactContent = await fs.readFile(analyzeImpactSrc, "utf-8");
+    await fs.writeFile(analyzeImpactDest, analyzeImpactContent);
+  } catch (error) {
+    console.warn(`⚠️  CI/CD 워크플로우 설정 경고:`, error);
+    // CI 설정 실패는 프로젝트 생성을 중단하지 않음
+  }
+}

package/src/commands/registry.ts

@@ -75,6 +75,7 @@ registerCommand({
       ui: ctx.options.ui as any,
       theme: ctx.options.theme === "true",
       minimal: ctx.options.minimal === "true",
+      withCi: ctx.options["with-ci"] === "true",
     });
   },
 });

package/src/main.ts

@@ -74,6 +74,7 @@ Options:
   --ui <library>      init 시 UI 라이브러리: shadcn, ark, none (기본: shadcn)
   --theme             init 시 다크모드 테마 시스템 추가
   --minimal           init 시 CSS/UI 없이 최소 템플릿 생성 (--css none --ui none)
+  --with-ci           init 시 GitHub Actions CI/CD 워크플로우 포함 (ATE E2E 테스트)
   --file <path>       spec-upsert spec 파일/monitor 로그 파일 경로
   --watch             build/guard arch 파일 감시 모드
   --output <path>     routes/openapi/doctor/contract/guard 출력 경로
@@ -111,6 +112,7 @@ Notes:
 
 Examples:
   bunx mandu init --name my-app                        # Tailwind + shadcn/ui 기본
+  bunx mandu init --name my-app --with-ci              # CI/CD 워크플로우 포함
   bunx mandu init --name chat-app --template realtime-chat  # 실시간 채팅 스타터 템플릿
   bunx mandu init my-app --minimal                     # CSS/UI 없이 최소 템플릿
   bunx mandu dev

package/templates/default/.github/README.md

@@ -0,0 +1,189 @@
+# GitHub Actions CI/CD for Mandu ATE
+
+이 디렉토리는 Mandu ATE (Automation Test Engine) E2E 테스트를 위한 GitHub Actions 워크플로우를 포함합니다.
+
+## 📋 워크플로우 개요
+
+### 1. `ate-e2e.yml` - 전체 E2E 테스트 실행
+
+**트리거:**
+- Pull Request (모든 브랜치)
+- `main` 브랜치로 Push
+
+**동작:**
+1. Bun 환경 설정
+2. 의존성 설치
+3. Playwright 브라우저 설치 (Chromium)
+4. ATE E2E 파이프라인 실행 (`bun run test:e2e:ci`)
+5. 테스트 리포트 아티팩트 업로드
+
+**사용 시나리오:**
+- 모든 E2E 테스트를 실행하여 전체 앱 동작 검증
+- 메인 브랜치 병합 전 안정성 확인
+
+### 2. `ate-e2e-subset.yml` - Impact Analysis 기반 서브셋 테스트
+
+**트리거:**
+- Pull Request (opened, synchronize, reopened)
+
+**동작:**
+1. **Impact Analysis 단계:**
+   - PR의 base와 head 간 변경 파일 분석
+   - `scripts/analyze-impact.ts`로 영향받는 테스트 식별
+   - 영향 범위가 없으면 테스트 스킵
+
+2. **서브셋 테스트 실행:**
+   - 영향받는 테스트만 선택적으로 실행
+   - Playwright의 `--grep` 옵션으로 필터링
+   - 테스트 결과를 PR 코멘트로 자동 게시
+
+**사용 시나리오:**
+- 빠른 피드백 루프 (변경 영향 범위만 테스트)
+- CI 실행 시간 최적화
+- 리소스 절약
+
+## 🚀 시작하기
+
+### 프로젝트 초기화 시 CI/CD 포함
+
+```bash
+bunx mandu init --name my-app --with-ci
+```
+
+이 명령은 자동으로 다음을 생성합니다:
+- `.github/workflows/ate-e2e.yml`
+- `.github/workflows/ate-e2e-subset.yml`
+- `scripts/analyze-impact.ts`
+
+### 기존 프로젝트에 추가
+
+1. 이 디렉토리의 워크플로우 파일들을 복사:
+   ```bash
+   cp -r .github/workflows your-project/.github/workflows
+   ```
+
+2. Impact Analysis 스크립트 복사:
+   ```bash
+   cp scripts/analyze-impact.ts your-project/scripts/
+   ```
+
+3. `package.json`에 CI 스크립트 추가:
+   ```json
+   {
+     "scripts": {
+       "test:e2e:ci": "bun run test:auto --ci"
+     }
+   }
+   ```
+
+## 📊 Impact Analysis 커스터마이징
+
+`scripts/analyze-impact.ts` 파일의 `IMPACT_MAP`을 수정하여 프로젝트 구조에 맞게 조정할 수 있습니다:
+
+```typescript
+const IMPACT_MAP: ImpactMap = {
+  // API routes → API 테스트
+  "app/api/**": ["**/api*.spec.ts", "**/api*.test.ts"],
+
+  // Client components → UI 테스트
+  "src/client/**": ["**/ui*.spec.ts", "**/component*.spec.ts"],
+
+  // 커스텀 매핑 추가
+  "src/features/auth/**": ["**/auth*.spec.ts"],
+};
+```
+
+## 🔍 워크플로우 상태 확인
+
+### GitHub Actions UI
+1. Repository → Actions 탭
+2. 워크플로우 실행 목록 확인
+3. 각 실행 클릭하여 상세 로그 확인
+
+### PR 코멘트
+`ate-e2e-subset.yml`는 테스트 결과를 PR에 자동으로 코멘트로 추가합니다:
+```
+## 🧪 ATE E2E Test Results (Subset)
+
+**Affected tests**: **/ui*.spec.ts|**/component*.spec.ts
+
+✅ Passed: 12
+❌ Failed: 0
+⏭️ Skipped: 3
+```
+
+### 아티팩트 다운로드
+테스트 실패 시 다음 아티팩트를 다운로드하여 분석:
+- `playwright-report`: HTML 리포트
+- `test-results`: 스크린샷, 비디오 등
+
+## 🛠️ 고급 설정
+
+### 환경 변수 설정
+
+GitHub Repository Settings → Secrets and variables → Actions에서 환경 변수 추가:
+
+```yaml
+env:
+  API_BASE_URL: ${{ secrets.API_BASE_URL }}
+  DATABASE_URL: ${{ secrets.DATABASE_URL }}
+```
+
+### 다중 브라우저 테스트
+
+`ate-e2e.yml`을 수정하여 여러 브라우저에서 테스트:
+
+```yaml
+strategy:
+  matrix:
+    browser: [chromium, firefox, webkit]
+steps:
+  - name: Install Playwright browsers
+    run: bunx playwright install --with-deps ${{ matrix.browser }}
+```
+
+### 병렬 실행
+
+```yaml
+strategy:
+  matrix:
+    shard: [1, 2, 3, 4]
+steps:
+  - name: Run tests
+    run: bun run test:e2e:ci --shard=${{ matrix.shard }}/4
+```
+
+### Slack 알림 추가
+
+```yaml
+- name: Notify Slack
+  if: failure()
+  uses: slackapi/slack-github-action@v1
+  with:
+    webhook-url: ${{ secrets.SLACK_WEBHOOK_URL }}
+    payload: |
+      {
+        "text": "E2E Tests Failed: ${{ github.event.pull_request.html_url }}"
+      }
+```
+
+## 📝 트러블슈팅
+
+### 테스트가 스킵되는 경우
+- `scripts/analyze-impact.ts`의 IMPACT_MAP 확인
+- 변경된 파일이 매핑에 포함되어 있는지 확인
+- 로그에서 "Analyzing changes" 출력 확인
+
+### Playwright 브라우저 설치 실패
+- `bunx playwright install --with-deps chromium` 직접 실행
+- Ubuntu 버전 확인 (ubuntu-latest 사용 권장)
+
+### 아티팩트 업로드 실패
+- `.mandu/reports/` 디렉토리 존재 확인
+- 테스트 실행이 성공적으로 완료되었는지 확인
+
+## 📚 참고 자료
+
+- [Mandu ATE 문서](../../docs/ATE.md)
+- [GitHub Actions 문서](https://docs.github.com/en/actions)
+- [Playwright CI 가이드](https://playwright.dev/docs/ci)

package/templates/default/.github/workflows/ate-e2e-subset.yml

@@ -0,0 +1,138 @@
+name: ATE E2E Tests (Subset - Impact Analysis)
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  analyze-changes:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    outputs:
+      affected-tests: ${{ steps.impact.outputs.tests }}
+      should-run: ${{ steps.impact.outputs.should-run }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Analyze impact
+        id: impact
+        run: |
+          # Get changed files between base and head
+          BASE_SHA="${{ github.event.pull_request.base.sha }}"
+          HEAD_SHA="${{ github.event.pull_request.head.sha }}"
+
+          echo "Analyzing changes between $BASE_SHA and $HEAD_SHA"
+
+          # Get list of changed files
+          CHANGED_FILES=$(git diff --name-only "$BASE_SHA" "$HEAD_SHA")
+
+          echo "Changed files:"
+          echo "$CHANGED_FILES"
+
+          # Create a temporary file for impact analysis
+          echo "$CHANGED_FILES" > changed-files.txt
+
+          # Run impact analysis (assuming you have a script for this)
+          # This is a placeholder - implement actual impact analysis logic
+          if [ -f "scripts/analyze-impact.ts" ]; then
+            AFFECTED_TESTS=$(bun run scripts/analyze-impact.ts changed-files.txt)
+          else
+            # Fallback: run all tests if impact analysis script doesn't exist
+            AFFECTED_TESTS="all"
+          fi
+
+          echo "Affected tests: $AFFECTED_TESTS"
+
+          # Set outputs
+          if [ "$AFFECTED_TESTS" = "none" ]; then
+            echo "should-run=false" >> $GITHUB_OUTPUT
+            echo "tests=" >> $GITHUB_OUTPUT
+          else
+            echo "should-run=true" >> $GITHUB_OUTPUT
+            echo "tests=$AFFECTED_TESTS" >> $GITHUB_OUTPUT
+          fi
+
+  e2e-subset:
+    needs: analyze-changes
+    if: needs.analyze-changes.outputs.should-run == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Install Playwright browsers
+        run: bunx playwright install --with-deps chromium
+
+      - name: Run affected E2E tests
+        run: |
+          AFFECTED_TESTS="${{ needs.analyze-changes.outputs.affected-tests }}"
+
+          if [ "$AFFECTED_TESTS" = "all" ]; then
+            echo "Running all E2E tests"
+            bun run test:e2e:ci
+          else
+            echo "Running subset of E2E tests: $AFFECTED_TESTS"
+            # Pass affected test patterns to Playwright
+            bun run test:e2e:ci --grep "$AFFECTED_TESTS"
+          fi
+        env:
+          CI: true
+
+      - name: Upload Playwright Report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report-subset
+          path: .mandu/reports/
+          retention-days: 7
+
+      - name: Comment PR with test results
+        if: always()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const affectedTests = '${{ needs.analyze-changes.outputs.affected-tests }}';
+
+            let body = '## 🧪 ATE E2E Test Results (Subset)\n\n';
+            body += `**Affected tests**: ${affectedTests === 'all' ? 'All tests' : affectedTests}\n\n`;
+
+            // Try to read test results summary
+            try {
+              const summary = fs.readFileSync('.mandu/reports/summary.json', 'utf8');
+              const results = JSON.parse(summary);
+              body += `✅ Passed: ${results.passed}\n`;
+              body += `❌ Failed: ${results.failed}\n`;
+              body += `⏭️ Skipped: ${results.skipped}\n`;
+            } catch (e) {
+              body += '_Test summary not available_\n';
+            }
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: body
+            });

package/templates/default/.github/workflows/ate-e2e.yml

@@ -0,0 +1,47 @@
+name: ATE E2E Tests
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Install Playwright browsers
+        run: bunx playwright install --with-deps chromium
+
+      - name: Run ATE E2E pipeline
+        run: bun run test:e2e:ci
+        env:
+          CI: true
+
+      - name: Upload Playwright Report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: .mandu/reports/
+          retention-days: 7
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: .mandu/test-results/
+          retention-days: 7

package/templates/default/scripts/analyze-impact.ts

@@ -0,0 +1,119 @@
+#!/usr/bin/env bun
+
+/**
+ * Impact Analysis Script
+ * 변경된 파일 목록을 기반으로 영향받는 E2E 테스트 식별
+ *
+ * Usage:
+ *   bun run scripts/analyze-impact.ts changed-files.txt
+ */
+
+import fs from "fs/promises";
+import path from "path";
+
+interface ImpactMap {
+  [pattern: string]: string[];
+}
+
+/**
+ * 파일 패턴과 영향받는 테스트 매핑
+ * 프로젝트 구조에 맞게 커스터마이즈 가능
+ */
+const IMPACT_MAP: ImpactMap = {
+  // API routes → API 테스트
+  "app/api/**": ["**/api*.spec.ts", "**/api*.test.ts"],
+
+  // Client components → UI 테스트
+  "src/client/**": ["**/ui*.spec.ts", "**/component*.spec.ts"],
+
+  // Server logic → Integration 테스트
+  "src/server/**": ["**/integration*.spec.ts", "**/server*.spec.ts"],
+
+  // Shared contracts → 모든 통합 테스트
+  "src/shared/contracts/**": ["**/integration*.spec.ts", "**/e2e*.spec.ts"],
+
+  // Database/Schema → 데이터 관련 테스트
+  "src/shared/schema/**": ["**/db*.spec.ts", "**/data*.spec.ts"],
+
+  // Config files → 모든 테스트
+  "*.config.*": ["**/*.spec.ts"],
+  "package.json": ["**/*.spec.ts"],
+};
+
+/**
+ * Glob 패턴 매칭 (간단한 구현)
+ */
+function matchPattern(filePath: string, pattern: string): boolean {
+  const regexPattern = pattern
+    .replace(/\*\*/g, ".*")
+    .replace(/\*/g, "[^/]*")
+    .replace(/\./g, "\\.");
+
+  const regex = new RegExp(`^${regexPattern}$`);
+  return regex.test(filePath);
+}
+
+/**
+ * 변경된 파일 목록을 기반으로 영향받는 테스트 패턴 추출
+ */
+function analyzeImpact(changedFiles: string[]): string[] {
+  const affectedTestPatterns = new Set<string>();
+
+  for (const file of changedFiles) {
+    const normalizedPath = file.replace(/\\/g, "/");
+
+    for (const [pattern, tests] of Object.entries(IMPACT_MAP)) {
+      if (matchPattern(normalizedPath, pattern)) {
+        tests.forEach((test) => affectedTestPatterns.add(test));
+      }
+    }
+  }
+
+  return Array.from(affectedTestPatterns);
+}
+
+/**
+ * Main
+ */
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error("Usage: bun run scripts/analyze-impact.ts <changed-files.txt>");
+    process.exit(1);
+  }
+
+  const changedFilesPath = args[0];
+
+  try {
+    // Read changed files
+    const content = await fs.readFile(changedFilesPath, "utf-8");
+    const changedFiles = content
+      .split("\n")
+      .map((line) => line.trim())
+      .filter((line) => line.length > 0);
+
+    if (changedFiles.length === 0) {
+      console.log("none");
+      return;
+    }
+
+    // Analyze impact
+    const affectedTests = analyzeImpact(changedFiles);
+
+    if (affectedTests.length === 0) {
+      console.log("none");
+      return;
+    }
+
+    // Output affected test patterns (Playwright grep format)
+    const grepPattern = affectedTests.join("|");
+    console.log(grepPattern);
+  } catch (error) {
+    console.error("Error analyzing impact:", error);
+    // Fallback: run all tests
+    console.log("all");
+  }
+}
+
+main();

package/templates/realtime-chat/.github/README.md

@@ -0,0 +1,189 @@
+# GitHub Actions CI/CD for Mandu ATE
+
+이 디렉토리는 Mandu ATE (Automation Test Engine) E2E 테스트를 위한 GitHub Actions 워크플로우를 포함합니다.
+
+## 📋 워크플로우 개요
+
+### 1. `ate-e2e.yml` - 전체 E2E 테스트 실행
+
+**트리거:**
+- Pull Request (모든 브랜치)
+- `main` 브랜치로 Push
+
+**동작:**
+1. Bun 환경 설정
+2. 의존성 설치
+3. Playwright 브라우저 설치 (Chromium)
+4. ATE E2E 파이프라인 실행 (`bun run test:e2e:ci`)
+5. 테스트 리포트 아티팩트 업로드
+
+**사용 시나리오:**
+- 모든 E2E 테스트를 실행하여 전체 앱 동작 검증
+- 메인 브랜치 병합 전 안정성 확인
+
+### 2. `ate-e2e-subset.yml` - Impact Analysis 기반 서브셋 테스트
+
+**트리거:**
+- Pull Request (opened, synchronize, reopened)
+
+**동작:**
+1. **Impact Analysis 단계:**
+   - PR의 base와 head 간 변경 파일 분석
+   - `scripts/analyze-impact.ts`로 영향받는 테스트 식별
+   - 영향 범위가 없으면 테스트 스킵
+
+2. **서브셋 테스트 실행:**
+   - 영향받는 테스트만 선택적으로 실행
+   - Playwright의 `--grep` 옵션으로 필터링
+   - 테스트 결과를 PR 코멘트로 자동 게시
+
+**사용 시나리오:**
+- 빠른 피드백 루프 (변경 영향 범위만 테스트)
+- CI 실행 시간 최적화
+- 리소스 절약
+
+## 🚀 시작하기
+
+### 프로젝트 초기화 시 CI/CD 포함
+
+```bash
+bunx mandu init --name my-app --with-ci
+```
+
+이 명령은 자동으로 다음을 생성합니다:
+- `.github/workflows/ate-e2e.yml`
+- `.github/workflows/ate-e2e-subset.yml`
+- `scripts/analyze-impact.ts`
+
+### 기존 프로젝트에 추가
+
+1. 이 디렉토리의 워크플로우 파일들을 복사:
+   ```bash
+   cp -r .github/workflows your-project/.github/workflows
+   ```
+
+2. Impact Analysis 스크립트 복사:
+   ```bash
+   cp scripts/analyze-impact.ts your-project/scripts/
+   ```
+
+3. `package.json`에 CI 스크립트 추가:
+   ```json
+   {
+     "scripts": {
+       "test:e2e:ci": "bun run test:auto --ci"
+     }
+   }
+   ```
+
+## 📊 Impact Analysis 커스터마이징
+
+`scripts/analyze-impact.ts` 파일의 `IMPACT_MAP`을 수정하여 프로젝트 구조에 맞게 조정할 수 있습니다:
+
+```typescript
+const IMPACT_MAP: ImpactMap = {
+  // API routes → API 테스트
+  "app/api/**": ["**/api*.spec.ts", "**/api*.test.ts"],
+
+  // Client components → UI 테스트
+  "src/client/**": ["**/ui*.spec.ts", "**/component*.spec.ts"],
+
+  // 커스텀 매핑 추가
+  "src/features/auth/**": ["**/auth*.spec.ts"],
+};
+```
+
+## 🔍 워크플로우 상태 확인
+
+### GitHub Actions UI
+1. Repository → Actions 탭
+2. 워크플로우 실행 목록 확인
+3. 각 실행 클릭하여 상세 로그 확인
+
+### PR 코멘트
+`ate-e2e-subset.yml`는 테스트 결과를 PR에 자동으로 코멘트로 추가합니다:
+```
+## 🧪 ATE E2E Test Results (Subset)
+
+**Affected tests**: **/ui*.spec.ts|**/component*.spec.ts
+
+✅ Passed: 12
+❌ Failed: 0
+⏭️ Skipped: 3
+```
+
+### 아티팩트 다운로드
+테스트 실패 시 다음 아티팩트를 다운로드하여 분석:
+- `playwright-report`: HTML 리포트
+- `test-results`: 스크린샷, 비디오 등
+
+## 🛠️ 고급 설정
+
+### 환경 변수 설정
+
+GitHub Repository Settings → Secrets and variables → Actions에서 환경 변수 추가:
+
+```yaml
+env:
+  API_BASE_URL: ${{ secrets.API_BASE_URL }}
+  DATABASE_URL: ${{ secrets.DATABASE_URL }}
+```
+
+### 다중 브라우저 테스트
+
+`ate-e2e.yml`을 수정하여 여러 브라우저에서 테스트:
+
+```yaml
+strategy:
+  matrix:
+    browser: [chromium, firefox, webkit]
+steps:
+  - name: Install Playwright browsers
+    run: bunx playwright install --with-deps ${{ matrix.browser }}
+```
+
+### 병렬 실행
+
+```yaml
+strategy:
+  matrix:
+    shard: [1, 2, 3, 4]
+steps:
+  - name: Run tests
+    run: bun run test:e2e:ci --shard=${{ matrix.shard }}/4
+```
+
+### Slack 알림 추가
+
+```yaml
+- name: Notify Slack
+  if: failure()
+  uses: slackapi/slack-github-action@v1
+  with:
+    webhook-url: ${{ secrets.SLACK_WEBHOOK_URL }}
+    payload: |
+      {
+        "text": "E2E Tests Failed: ${{ github.event.pull_request.html_url }}"
+      }
+```
+
+## 📝 트러블슈팅
+
+### 테스트가 스킵되는 경우
+- `scripts/analyze-impact.ts`의 IMPACT_MAP 확인
+- 변경된 파일이 매핑에 포함되어 있는지 확인
+- 로그에서 "Analyzing changes" 출력 확인
+
+### Playwright 브라우저 설치 실패
+- `bunx playwright install --with-deps chromium` 직접 실행
+- Ubuntu 버전 확인 (ubuntu-latest 사용 권장)
+
+### 아티팩트 업로드 실패
+- `.mandu/reports/` 디렉토리 존재 확인
+- 테스트 실행이 성공적으로 완료되었는지 확인
+
+## 📚 참고 자료
+
+- [Mandu ATE 문서](../../docs/ATE.md)
+- [GitHub Actions 문서](https://docs.github.com/en/actions)
+- [Playwright CI 가이드](https://playwright.dev/docs/ci)

package/templates/realtime-chat/.github/workflows/ate-e2e-subset.yml

@@ -0,0 +1,138 @@
+name: ATE E2E Tests (Subset - Impact Analysis)
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  analyze-changes:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    outputs:
+      affected-tests: ${{ steps.impact.outputs.tests }}
+      should-run: ${{ steps.impact.outputs.should-run }}
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Analyze impact
+        id: impact
+        run: |
+          # Get changed files between base and head
+          BASE_SHA="${{ github.event.pull_request.base.sha }}"
+          HEAD_SHA="${{ github.event.pull_request.head.sha }}"
+
+          echo "Analyzing changes between $BASE_SHA and $HEAD_SHA"
+
+          # Get list of changed files
+          CHANGED_FILES=$(git diff --name-only "$BASE_SHA" "$HEAD_SHA")
+
+          echo "Changed files:"
+          echo "$CHANGED_FILES"
+
+          # Create a temporary file for impact analysis
+          echo "$CHANGED_FILES" > changed-files.txt
+
+          # Run impact analysis (assuming you have a script for this)
+          # This is a placeholder - implement actual impact analysis logic
+          if [ -f "scripts/analyze-impact.ts" ]; then
+            AFFECTED_TESTS=$(bun run scripts/analyze-impact.ts changed-files.txt)
+          else
+            # Fallback: run all tests if impact analysis script doesn't exist
+            AFFECTED_TESTS="all"
+          fi
+
+          echo "Affected tests: $AFFECTED_TESTS"
+
+          # Set outputs
+          if [ "$AFFECTED_TESTS" = "none" ]; then
+            echo "should-run=false" >> $GITHUB_OUTPUT
+            echo "tests=" >> $GITHUB_OUTPUT
+          else
+            echo "should-run=true" >> $GITHUB_OUTPUT
+            echo "tests=$AFFECTED_TESTS" >> $GITHUB_OUTPUT
+          fi
+
+  e2e-subset:
+    needs: analyze-changes
+    if: needs.analyze-changes.outputs.should-run == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Install Playwright browsers
+        run: bunx playwright install --with-deps chromium
+
+      - name: Run affected E2E tests
+        run: |
+          AFFECTED_TESTS="${{ needs.analyze-changes.outputs.affected-tests }}"
+
+          if [ "$AFFECTED_TESTS" = "all" ]; then
+            echo "Running all E2E tests"
+            bun run test:e2e:ci
+          else
+            echo "Running subset of E2E tests: $AFFECTED_TESTS"
+            # Pass affected test patterns to Playwright
+            bun run test:e2e:ci --grep "$AFFECTED_TESTS"
+          fi
+        env:
+          CI: true
+
+      - name: Upload Playwright Report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report-subset
+          path: .mandu/reports/
+          retention-days: 7
+
+      - name: Comment PR with test results
+        if: always()
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const affectedTests = '${{ needs.analyze-changes.outputs.affected-tests }}';
+
+            let body = '## 🧪 ATE E2E Test Results (Subset)\n\n';
+            body += `**Affected tests**: ${affectedTests === 'all' ? 'All tests' : affectedTests}\n\n`;
+
+            // Try to read test results summary
+            try {
+              const summary = fs.readFileSync('.mandu/reports/summary.json', 'utf8');
+              const results = JSON.parse(summary);
+              body += `✅ Passed: ${results.passed}\n`;
+              body += `❌ Failed: ${results.failed}\n`;
+              body += `⏭️ Skipped: ${results.skipped}\n`;
+            } catch (e) {
+              body += '_Test summary not available_\n';
+            }
+
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: body
+            });

package/templates/realtime-chat/.github/workflows/ate-e2e.yml

@@ -0,0 +1,47 @@
+name: ATE E2E Tests
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+jobs:
+  e2e:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Install Playwright browsers
+        run: bunx playwright install --with-deps chromium
+
+      - name: Run ATE E2E pipeline
+        run: bun run test:e2e:ci
+        env:
+          CI: true
+
+      - name: Upload Playwright Report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: .mandu/reports/
+          retention-days: 7
+
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: test-results
+          path: .mandu/test-results/
+          retention-days: 7

package/templates/realtime-chat/scripts/analyze-impact.ts

@@ -0,0 +1,119 @@
+#!/usr/bin/env bun
+
+/**
+ * Impact Analysis Script
+ * 변경된 파일 목록을 기반으로 영향받는 E2E 테스트 식별
+ *
+ * Usage:
+ *   bun run scripts/analyze-impact.ts changed-files.txt
+ */
+
+import fs from "fs/promises";
+import path from "path";
+
+interface ImpactMap {
+  [pattern: string]: string[];
+}
+
+/**
+ * 파일 패턴과 영향받는 테스트 매핑
+ * 프로젝트 구조에 맞게 커스터마이즈 가능
+ */
+const IMPACT_MAP: ImpactMap = {
+  // API routes → API 테스트
+  "app/api/**": ["**/api*.spec.ts", "**/api*.test.ts"],
+
+  // Client components → UI 테스트
+  "src/client/**": ["**/ui*.spec.ts", "**/component*.spec.ts"],
+
+  // Server logic → Integration 테스트
+  "src/server/**": ["**/integration*.spec.ts", "**/server*.spec.ts"],
+
+  // Shared contracts → 모든 통합 테스트
+  "src/shared/contracts/**": ["**/integration*.spec.ts", "**/e2e*.spec.ts"],
+
+  // Database/Schema → 데이터 관련 테스트
+  "src/shared/schema/**": ["**/db*.spec.ts", "**/data*.spec.ts"],
+
+  // Config files → 모든 테스트
+  "*.config.*": ["**/*.spec.ts"],
+  "package.json": ["**/*.spec.ts"],
+};
+
+/**
+ * Glob 패턴 매칭 (간단한 구현)
+ */
+function matchPattern(filePath: string, pattern: string): boolean {
+  const regexPattern = pattern
+    .replace(/\*\*/g, ".*")
+    .replace(/\*/g, "[^/]*")
+    .replace(/\./g, "\\.");
+
+  const regex = new RegExp(`^${regexPattern}$`);
+  return regex.test(filePath);
+}
+
+/**
+ * 변경된 파일 목록을 기반으로 영향받는 테스트 패턴 추출
+ */
+function analyzeImpact(changedFiles: string[]): string[] {
+  const affectedTestPatterns = new Set<string>();
+
+  for (const file of changedFiles) {
+    const normalizedPath = file.replace(/\\/g, "/");
+
+    for (const [pattern, tests] of Object.entries(IMPACT_MAP)) {
+      if (matchPattern(normalizedPath, pattern)) {
+        tests.forEach((test) => affectedTestPatterns.add(test));
+      }
+    }
+  }
+
+  return Array.from(affectedTestPatterns);
+}
+
+/**
+ * Main
+ */
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0) {
+    console.error("Usage: bun run scripts/analyze-impact.ts <changed-files.txt>");
+    process.exit(1);
+  }
+
+  const changedFilesPath = args[0];
+
+  try {
+    // Read changed files
+    const content = await fs.readFile(changedFilesPath, "utf-8");
+    const changedFiles = content
+      .split("\n")
+      .map((line) => line.trim())
+      .filter((line) => line.length > 0);
+
+    if (changedFiles.length === 0) {
+      console.log("none");
+      return;
+    }
+
+    // Analyze impact
+    const affectedTests = analyzeImpact(changedFiles);
+
+    if (affectedTests.length === 0) {
+      console.log("none");
+      return;
+    }
+
+    // Output affected test patterns (Playwright grep format)
+    const grepPattern = affectedTests.join("|");
+    console.log(grepPattern);
+  } catch (error) {
+    console.error("Error analyzing impact:", error);
+    // Fallback: run all tests
+    console.log("all");
+  }
+}
+
+main();