bitbucket-gemini-action 1.0.11 → 1.0.13

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

@@ -169,16 +169,21 @@ class BitbucketClient {
   async getPullRequestCommits(workspace, repoSlug, prId) {
     return this.paginatedRequest(`/repositories/${workspace}/${repoSlug}/pullrequests/${prId}/commits`);
   }
-  async createPullRequestComment(workspace, repoSlug, prId, content, inline) {
+  async createPullRequestComment(workspace, repoSlug, prId, content, options) {
     const body = {
       content: {
         raw: content
       }
     };
-    if (inline) {
+    if (options?.inline) {
       body.inline = {
-        to: inline.line,
-        path: inline.path
+        from: options.inline.line,
+        path: options.inline.path
+      };
+    }
+    if (options?.parentId) {
+      body.parent = {
+        id: options.parentId
       };
     }
     return this.request(`/repositories/${workspace}/${repoSlug}/pullrequests/${prId}/comments`, {
@@ -2849,19 +2854,21 @@ function detectMode(context, options) {
       reason: `Explicitly specified mode: ${options.mode}`
     };
   }
+  if (context.eventType === "pullrequest:comment_created" || context.eventType === "pullrequest:comment_updated") {
+    const tagTrigger = tagMode.shouldTrigger(context, {
+      triggerPhrase: options.triggerPhrase
+    });
+    if (tagTrigger.shouldTrigger) {
+      return {
+        mode: tagMode,
+        reason: "Trigger phrase detected in comment"
+      };
+    }
+  }
   if (options.prompt) {
     return {
       mode: agentMode,
-      reason: "Explicit prompt provided"
-    };
-  }
-  const tagTrigger = tagMode.shouldTrigger(context, {
-    triggerPhrase: options.triggerPhrase
-  });
-  if (tagTrigger.shouldTrigger) {
-    return {
-      mode: tagMode,
-      reason: "Trigger phrase detected in comment"
+      reason: "Explicit prompt provided for auto-review"
     };
   }
   if (context.eventType === "manual" || context.eventType === "schedule") {
@@ -2878,23 +2885,33 @@ function detectMode(context, options) {
 
 // src/bitbucket/validation/trigger.ts
 function validateTrigger(context, options) {
-  if (options.prompt) {
+  if (context.eventType === "pullrequest:comment_created" || context.eventType === "pullrequest:comment_updated") {
+    const commentResult = validateCommentTrigger(context.comment, options);
+    if (commentResult.shouldTrigger) {
+      return commentResult;
+    }
     return {
-      shouldTrigger: true,
-      reason: "Explicit prompt provided",
-      triggerType: "automation",
-      userMessage: options.prompt
+      shouldTrigger: false,
+      reason: `Comment event but no trigger phrase found`
     };
   }
   if (context.eventType === "manual" || context.eventType === "schedule") {
     return {
       shouldTrigger: true,
       reason: `Triggered by ${context.eventType} event`,
-      triggerType: "manual"
+      triggerType: "manual",
+      userMessage: options.prompt
     };
   }
-  if (context.eventType === "pullrequest:comment_created" || context.eventType === "pullrequest:comment_updated") {
-    return validateCommentTrigger(context.comment, options);
+  if (options.prompt) {
+    if (context.eventType === "pullrequest:created" || context.eventType === "pullrequest:updated" || context.isPR) {
+      return {
+        shouldTrigger: true,
+        reason: "Explicit prompt provided for PR event",
+        triggerType: "automation",
+        userMessage: options.prompt
+      };
+    }
   }
   return {
     shouldTrigger: false,
@@ -7214,6 +7231,7 @@ async function prepare() {
       containsTrigger: true,
       mode: mode.name,
       trackingCommentId: modeResult.trackingCommentId,
+      triggerCommentId: context.comment?.id,
       prompt: triggerResult.userMessage || config.PROMPT || "",
       systemPrompt: modeResult.modeContext.systemPrompt,
       tools: modeResult.modeContext.tools,
@@ -8283,12 +8301,11 @@ async function updateTrackingComment(client, workspace, repoSlug, prId, commentI
 }
 async function createInlineComment(client, workspace, repoSlug, prId, filePath, line, content) {
   return client.createPullRequestComment(workspace, repoSlug, prId, content, {
-    path: filePath,
-    line
+    inline: { path: filePath, line }
   });
 }
-async function createPRComment(client, workspace, repoSlug, prId, content) {
-  return client.createPullRequestComment(workspace, repoSlug, prId, content);
+async function createPRComment(client, workspace, repoSlug, prId, content, parentId) {
+  return client.createPullRequestComment(workspace, repoSlug, prId, content, parentId ? { parentId } : undefined);
 }
 function formatTrackingComment(content) {
   const statusEmoji = getStatusEmoji(content.status);
@@ -8482,16 +8499,15 @@ async function execute(options) {
     console.log(`✅ Gemini response received (${response.finishReason})`);
     let inlineCommentsCreated = 0;
     if (response.toolCalls && context.entityNumber) {
-      inlineCommentsCreated = await processToolCalls(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.toolCalls, opts.trackingCommentId);
+      inlineCommentsCreated = await processToolCalls(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.toolCalls, opts.trackingCommentId, opts.triggerCommentId);
     }
     if (!response.toolCalls?.length && response.text && context.entityNumber) {
-      await createPRComment(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.text);
+      await createPRComment(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.text, opts.triggerCommentId);
     }
     if (opts.trackingCommentId && context.entityNumber) {
       await updateTrackingComment(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, opts.trackingCommentId, {
         status: "completed",
         message: "Review completed successfully.",
-        summary: response.text.substring(0, 500),
         inlineCommentsCount: inlineCommentsCreated
       });
     }
@@ -8523,7 +8539,7 @@ async function execute(options) {
     };
   }
 }
-async function processToolCalls(client, workspace, repoSlug, prId, toolCalls, trackingCommentId) {
+async function processToolCalls(client, workspace, repoSlug, prId, toolCalls, trackingCommentId, triggerCommentId) {
   let inlineCommentsCreated = 0;
   for (const toolCall of toolCalls) {
     console.log(`\uD83D\uDD27 Processing tool call: ${toolCall.name}`);
@@ -8537,7 +8553,7 @@ async function processToolCalls(client, workspace, repoSlug, prId, toolCalls, tr
         }
         case "create_pr_comment": {
           const args = toolCall.args;
-          await createPRComment(client, workspace, repoSlug, prId, args.content);
+          await createPRComment(client, workspace, repoSlug, prId, args.content, triggerCommentId);
           break;
         }
         case "update_tracking_comment": {
@@ -8571,7 +8587,8 @@ function loadPrepareOutput() {
     mode: data.mode || "tag",
     prompt: data.prompt || "",
     systemPrompt: data.systemPrompt || "",
-    trackingCommentId: data.trackingCommentId
+    trackingCommentId: data.trackingCommentId,
+    triggerCommentId: data.triggerCommentId
   };
 }
 

package/dist/entrypoints/execute.js

@@ -1113,16 +1113,21 @@ class BitbucketClient {
   async getPullRequestCommits(workspace, repoSlug, prId) {
     return this.paginatedRequest(`/repositories/${workspace}/${repoSlug}/pullrequests/${prId}/commits`);
   }
-  async createPullRequestComment(workspace, repoSlug, prId, content, inline) {
+  async createPullRequestComment(workspace, repoSlug, prId, content, options) {
     const body = {
       content: {
         raw: content
       }
     };
-    if (inline) {
+    if (options?.inline) {
       body.inline = {
-        to: inline.line,
-        path: inline.path
+        from: options.inline.line,
+        path: options.inline.path
+      };
+    }
+    if (options?.parentId) {
+      body.parent = {
+        id: options.parentId
       };
     }
     return this.request(`/repositories/${workspace}/${repoSlug}/pullrequests/${prId}/comments`, {
@@ -3741,12 +3746,11 @@ async function updateTrackingComment(client, workspace, repoSlug, prId, commentI
 }
 async function createInlineComment(client, workspace, repoSlug, prId, filePath, line, content) {
   return client.createPullRequestComment(workspace, repoSlug, prId, content, {
-    path: filePath,
-    line
+    inline: { path: filePath, line }
   });
 }
-async function createPRComment(client, workspace, repoSlug, prId, content) {
-  return client.createPullRequestComment(workspace, repoSlug, prId, content);
+async function createPRComment(client, workspace, repoSlug, prId, content, parentId) {
+  return client.createPullRequestComment(workspace, repoSlug, prId, content, parentId ? { parentId } : undefined);
 }
 function formatTrackingComment(content) {
   const statusEmoji = getStatusEmoji(content.status);
@@ -7988,16 +7992,15 @@ async function execute(options) {
     console.log(`✅ Gemini response received (${response.finishReason})`);
     let inlineCommentsCreated = 0;
     if (response.toolCalls && context.entityNumber) {
-      inlineCommentsCreated = await processToolCalls(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.toolCalls, opts.trackingCommentId);
+      inlineCommentsCreated = await processToolCalls(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.toolCalls, opts.trackingCommentId, opts.triggerCommentId);
     }
     if (!response.toolCalls?.length && response.text && context.entityNumber) {
-      await createPRComment(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.text);
+      await createPRComment(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, response.text, opts.triggerCommentId);
     }
     if (opts.trackingCommentId && context.entityNumber) {
       await updateTrackingComment(bitbucketClient, context.workspace, context.repoSlug, context.entityNumber, opts.trackingCommentId, {
         status: "completed",
         message: "Review completed successfully.",
-        summary: response.text.substring(0, 500),
         inlineCommentsCount: inlineCommentsCreated
       });
     }
@@ -8029,7 +8032,7 @@ async function execute(options) {
     };
   }
 }
-async function processToolCalls(client, workspace, repoSlug, prId, toolCalls, trackingCommentId) {
+async function processToolCalls(client, workspace, repoSlug, prId, toolCalls, trackingCommentId, triggerCommentId) {
   let inlineCommentsCreated = 0;
   for (const toolCall of toolCalls) {
     console.log(`\uD83D\uDD27 Processing tool call: ${toolCall.name}`);
@@ -8043,7 +8046,7 @@ async function processToolCalls(client, workspace, repoSlug, prId, toolCalls, tr
         }
         case "create_pr_comment": {
           const args = toolCall.args;
-          await createPRComment(client, workspace, repoSlug, prId, args.content);
+          await createPRComment(client, workspace, repoSlug, prId, args.content, triggerCommentId);
           break;
         }
         case "update_tracking_comment": {
@@ -8077,7 +8080,8 @@ function loadPrepareOutput() {
     mode: data.mode || "tag",
     prompt: data.prompt || "",
     systemPrompt: data.systemPrompt || "",
-    trackingCommentId: data.trackingCommentId
+    trackingCommentId: data.trackingCommentId,
+    triggerCommentId: data.triggerCommentId
   };
 }
 export {

package/dist/entrypoints/prepare.js

@@ -168,16 +168,21 @@ class BitbucketClient {
   async getPullRequestCommits(workspace, repoSlug, prId) {
     return this.paginatedRequest(`/repositories/${workspace}/${repoSlug}/pullrequests/${prId}/commits`);
   }
-  async createPullRequestComment(workspace, repoSlug, prId, content, inline) {
+  async createPullRequestComment(workspace, repoSlug, prId, content, options) {
     const body = {
       content: {
         raw: content
       }
     };
-    if (inline) {
+    if (options?.inline) {
       body.inline = {
-        to: inline.line,
-        path: inline.path
+        from: options.inline.line,
+        path: options.inline.path
+      };
+    }
+    if (options?.parentId) {
+      body.parent = {
+        id: options.parentId
       };
     }
     return this.request(`/repositories/${workspace}/${repoSlug}/pullrequests/${prId}/comments`, {
@@ -2848,19 +2853,21 @@ function detectMode(context, options) {
       reason: `Explicitly specified mode: ${options.mode}`
     };
   }
+  if (context.eventType === "pullrequest:comment_created" || context.eventType === "pullrequest:comment_updated") {
+    const tagTrigger = tagMode.shouldTrigger(context, {
+      triggerPhrase: options.triggerPhrase
+    });
+    if (tagTrigger.shouldTrigger) {
+      return {
+        mode: tagMode,
+        reason: "Trigger phrase detected in comment"
+      };
+    }
+  }
   if (options.prompt) {
     return {
       mode: agentMode,
-      reason: "Explicit prompt provided"
-    };
-  }
-  const tagTrigger = tagMode.shouldTrigger(context, {
-    triggerPhrase: options.triggerPhrase
-  });
-  if (tagTrigger.shouldTrigger) {
-    return {
-      mode: tagMode,
-      reason: "Trigger phrase detected in comment"
+      reason: "Explicit prompt provided for auto-review"
     };
   }
   if (context.eventType === "manual" || context.eventType === "schedule") {
@@ -2877,23 +2884,33 @@ function detectMode(context, options) {
 
 // src/bitbucket/validation/trigger.ts
 function validateTrigger(context, options) {
-  if (options.prompt) {
+  if (context.eventType === "pullrequest:comment_created" || context.eventType === "pullrequest:comment_updated") {
+    const commentResult = validateCommentTrigger(context.comment, options);
+    if (commentResult.shouldTrigger) {
+      return commentResult;
+    }
     return {
-      shouldTrigger: true,
-      reason: "Explicit prompt provided",
-      triggerType: "automation",
-      userMessage: options.prompt
+      shouldTrigger: false,
+      reason: `Comment event but no trigger phrase found`
     };
   }
   if (context.eventType === "manual" || context.eventType === "schedule") {
     return {
       shouldTrigger: true,
       reason: `Triggered by ${context.eventType} event`,
-      triggerType: "manual"
+      triggerType: "manual",
+      userMessage: options.prompt
     };
   }
-  if (context.eventType === "pullrequest:comment_created" || context.eventType === "pullrequest:comment_updated") {
-    return validateCommentTrigger(context.comment, options);
+  if (options.prompt) {
+    if (context.eventType === "pullrequest:created" || context.eventType === "pullrequest:updated" || context.isPR) {
+      return {
+        shouldTrigger: true,
+        reason: "Explicit prompt provided for PR event",
+        triggerType: "automation",
+        userMessage: options.prompt
+      };
+    }
   }
   return {
     shouldTrigger: false,
@@ -7213,6 +7230,7 @@ async function prepare() {
       containsTrigger: true,
       mode: mode.name,
       trackingCommentId: modeResult.trackingCommentId,
+      triggerCommentId: context.comment?.id,
       prompt: triggerResult.userMessage || config.PROMPT || "",
       systemPrompt: modeResult.modeContext.systemPrompt,
       tools: modeResult.modeContext.tools,

package/package.json

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