bitbucket-gemini-action 1.0.11 → 1.0.12

package/README.md

@@ -52,6 +52,8 @@ pipelines:
 - `@gemini what does this function do?`
 - `@gemini check for security issues`
 
+> **Note**: `@gemini` 멘션 기능을 사용하려면 [웹훅 설정](#webhook-setup-for-gemini-mentions)이 필요합니다.
+
 ## Configuration
 
 ### Environment Variables
@@ -235,6 +237,119 @@ Triggered by providing a `PROMPT` variable. Executes predefined tasks automatica
       - npx bitbucket-gemini-action
 ```
 
+### 자동 리뷰 + @gemini 멘션 동시 사용
+
+두 기능을 동시에 사용하려면:
+
+1. **자동 리뷰**: `PROMPT` 환경변수로 PR 생성/업데이트 시 자동 실행
+2. **@gemini 멘션**: 웹훅으로 코멘트 이벤트 수신 시 실행
+
+```yaml
+image: node:20
+
+pipelines:
+  pull-requests:
+    '**':
+      - step:
+          name: AI Code Review
+          script:
+            - export PROMPT="Review this PR"
+            - export ALLOW_BOTS=true
+            - export REVIEW_PRESETS="middle,nextjs,typescript"
+            - npx bitbucket-gemini-action@latest
+
+  custom:
+    gemini-comment:
+      - step:
+          name: Gemini Comment Handler
+          script:
+            - export ALLOW_BOTS=true
+            - npx bitbucket-gemini-action@latest
+```
+
+- `pull-requests` 파이프라인: PR 생성/업데이트 시 자동 리뷰
+- `custom/gemini-comment` 파이프라인: 웹훅에서 코멘트 이벤트 수신 시 `@gemini` 멘션 처리
+
+## Webhook Setup for @gemini Mentions
+
+`@gemini` 멘션 기능을 사용하려면 Bitbucket 웹훅과 중간 서버가 필요합니다.
+
+### 왜 중간 서버가 필요한가?
+
+Bitbucket Pipelines는 **외부 웹훅 URL로 직접 트리거할 수 없습니다**. 따라서:
+
+1. 웹훅 → 중간 서버 → Bitbucket API로 파이프라인 트리거
+
+### 옵션 1: 외부 서버 사용 (권장)
+
+AWS Lambda, Cloudflare Workers, 또는 별도 서버에서 웹훅을 수신하고 Bitbucket API를 호출:
+
+```javascript
+// Cloudflare Worker 예시
+export default {
+  async fetch(request, env) {
+    const payload = await request.json();
+
+    // @gemini 멘션 확인
+    if (!payload.comment?.content?.raw?.includes('@gemini')) {
+      return new Response('No trigger', { status: 200 });
+    }
+
+    // Bitbucket Pipeline API 호출
+    const response = await fetch(
+      `https://api.bitbucket.org/2.0/repositories/${payload.repository.full_name}/pipelines/`,
+      {
+        method: 'POST',
+        headers: {
+          'Authorization': `Bearer ${env.BITBUCKET_ACCESS_TOKEN}`,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          target: {
+            ref_type: 'branch',
+            type: 'pipeline_ref_target',
+            ref_name: payload.pullrequest.source.branch.name,
+            selector: {
+              type: 'custom',
+              pattern: 'gemini-comment',
+            },
+          },
+          variables: [
+            { key: 'WEBHOOK_PAYLOAD', value: JSON.stringify(payload) },
+            { key: 'TRIGGER_EVENT', value: 'pullrequest:comment_created' },
+          ],
+        }),
+      }
+    );
+
+    return new Response('Pipeline triggered', { status: 200 });
+  },
+};
+```
+
+### 옵션 2: Bitbucket Connect 앱 개발
+
+더 깊은 통합이 필요하면 Bitbucket Connect 앱을 개발하세요.
+
+### 웹훅 설정 방법
+
+1. **Repository Settings → Webhooks → Add webhook**
+2. **Title**: `bitbucket-gemini`
+3. **URL**: 중간 서버 URL (예: `https://your-worker.workers.dev/webhook`)
+4. **Triggers 선택**:
+   - ✅ Pull request: Comment created
+   - ✅ Pull request: Comment updated (선택사항)
+5. **Save**
+
+### 환경 변수
+
+웹훅 핸들러에서 파이프라인 트리거 시 다음 변수를 전달해야 합니다:
+
+| Variable | Description |
+|----------|-------------|
+| `WEBHOOK_PAYLOAD` | 웹훅 페이로드 JSON 문자열 |
+| `TRIGGER_EVENT` | `pullrequest:comment_created` 또는 `pullrequest:comment_updated` |
+
 ## Pipeline Examples
 
 ### Basic PR Review

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitbucket-gemini-action",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "description": "Bitbucket Pipeline action for AI-powered code review using Google Gemini",
   "type": "module",
   "main": "dist/index.js",