bitbucket-gemini-action 1.0.10 → 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/dist/cli.js

@@ -2320,7 +2320,11 @@ ${formatComments(context.comments)}` : ""}
 
 **모든 코멘트와 피드백은 반드시 한국어로 작성하세요.**
 
-특정 라인에 인라인 코멘트를 남기고, 전체적인 피드백은 요약 코멘트로 작성하세요.`;
+## 중요: 도구 사용 방법
+1. **create_inline_comment**: 코드의 특정 라인에 피드백을 남길 때 반드시 이 도구를 사용하세요. 개선이 필요한 각 코드 라인마다 개별적으로 호출하세요.
+2. **create_pr_comment**: 전체적인 요약만 이 도구로 작성하세요.
+
+피드백이 있는 모든 코드 라인에 대해 create_inline_comment를 사용해야 합니다.`;
 }
 function buildTagModePrompt(context, userMessage, mentionAuthor) {
   const filesSummary = context.files.map((f) => `- ${f.path} (${f.status}): +${f.additions}/-${f.deletions}`).join(`
@@ -2462,7 +2466,7 @@ ${presetPrompt}`;
 // src/gemini/tools.ts
 var createInlineCommentTool = {
   name: "create_inline_comment",
-  description: "Create an inline comment on a specific line of code in the pull request. Use this ONLY for significant issues like bugs, security problems, or important improvements. Do NOT comment on minor style issues or obvious code.",
+  description: "Create an inline comment on a specific line of code in the pull request. Use this tool for each line where you have feedback. This is the PRIMARY tool for code review comments.",
   parameters: {
     type: "object",
     properties: {

package/dist/entrypoints/execute.js

@@ -3420,7 +3420,11 @@ ${formatComments2(context.comments)}` : ""}
 
 **모든 코멘트와 피드백은 반드시 한국어로 작성하세요.**
 
-특정 라인에 인라인 코멘트를 남기고, 전체적인 피드백은 요약 코멘트로 작성하세요.`;
+## 중요: 도구 사용 방법
+1. **create_inline_comment**: 코드의 특정 라인에 피드백을 남길 때 반드시 이 도구를 사용하세요. 개선이 필요한 각 코드 라인마다 개별적으로 호출하세요.
+2. **create_pr_comment**: 전체적인 요약만 이 도구로 작성하세요.
+
+피드백이 있는 모든 코드 라인에 대해 create_inline_comment를 사용해야 합니다.`;
 }
 function buildTagModePrompt(context, userMessage, mentionAuthor) {
   const filesSummary = context.files.map((f) => `- ${f.path} (${f.status}): +${f.additions}/-${f.deletions}`).join(`
@@ -3562,7 +3566,7 @@ ${presetPrompt}`;
 // src/gemini/tools.ts
 var createInlineCommentTool = {
   name: "create_inline_comment",
-  description: "Create an inline comment on a specific line of code in the pull request. Use this ONLY for significant issues like bugs, security problems, or important improvements. Do NOT comment on minor style issues or obvious code.",
+  description: "Create an inline comment on a specific line of code in the pull request. Use this tool for each line where you have feedback. This is the PRIMARY tool for code review comments.",
   parameters: {
     type: "object",
     properties: {

package/dist/entrypoints/prepare.js

@@ -2319,7 +2319,11 @@ ${formatComments(context.comments)}` : ""}
 
 **모든 코멘트와 피드백은 반드시 한국어로 작성하세요.**
 
-특정 라인에 인라인 코멘트를 남기고, 전체적인 피드백은 요약 코멘트로 작성하세요.`;
+## 중요: 도구 사용 방법
+1. **create_inline_comment**: 코드의 특정 라인에 피드백을 남길 때 반드시 이 도구를 사용하세요. 개선이 필요한 각 코드 라인마다 개별적으로 호출하세요.
+2. **create_pr_comment**: 전체적인 요약만 이 도구로 작성하세요.
+
+피드백이 있는 모든 코드 라인에 대해 create_inline_comment를 사용해야 합니다.`;
 }
 function buildTagModePrompt(context, userMessage, mentionAuthor) {
   const filesSummary = context.files.map((f) => `- ${f.path} (${f.status}): +${f.additions}/-${f.deletions}`).join(`
@@ -2461,7 +2465,7 @@ ${presetPrompt}`;
 // src/gemini/tools.ts
 var createInlineCommentTool = {
   name: "create_inline_comment",
-  description: "Create an inline comment on a specific line of code in the pull request. Use this ONLY for significant issues like bugs, security problems, or important improvements. Do NOT comment on minor style issues or obvious code.",
+  description: "Create an inline comment on a specific line of code in the pull request. Use this tool for each line where you have feedback. This is the PRIMARY tool for code review comments.",
   parameters: {
     type: "object",
     properties: {

package/package.json

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