Add bot assignment functionality for GitHub/GitLab issues and PRs

- Add GITHUB_BOT_NAME and GITLAB_BOT_NAME environment variables
- Update frameworks to assign issues and PRs to specified bots
- Add assign_pull_request() and assign_merge_request() methods
- Update configuration files to use bot name environment variables
- Update documentation and examples with bot assignment setup
- Enhance check_config.py to show bot assignment status
- All ruff lint errors resolved

Co-authored-by: notfolder <20558197+notfolder@users.noreply.github.com>

Author: Copilot

tests/real_integration/.env.example

@@ -8,6 +8,7 @@
 # Required scopes: repo
 GITHUB_PERSONAL_ACCESS_TOKEN=ghp_your_github_token_here
 GITHUB_TEST_REPO=yourusername/your-test-repository
+GITHUB_BOT_NAME=coding-agent-bot
 
 # ================================
 # GitLab Configuration (Optional)
@@ -17,6 +18,7 @@ GITHUB_TEST_REPO=yourusername/your-test-repository
 GITLAB_PERSONAL_ACCESS_TOKEN=glpat-your_gitlab_token_here
 GITLAB_TEST_PROJECT=your-project-id-or-path
 GITLAB_API_URL=https://gitlab.com/api/v4
+GITLAB_BOT_NAME=coding-agent-bot
 
 # ================================
 # LLM Configuration (Required)

tests/real_integration/QUICKSTART.md

@@ -14,6 +14,7 @@ This is a quick guide to get the real integration tests running.
    ```bash
    export GITHUB_PERSONAL_ACCESS_TOKEN="ghp_your_token_here"
    export GITHUB_TEST_REPO="myuser/coding-agent-test"
+   export GITHUB_BOT_NAME="coding-agent-bot"  # Optional: bot for assignment
    export OPENAI_API_KEY="sk_your_openai_key_here"
    # Optional: For local LLM via OpenAI-compatible API
    export OPENAI_BASE_URL="http://localhost:1234/v1"
@@ -85,6 +86,7 @@ In your test repository:
 ```bash
 export GITLAB_PERSONAL_ACCESS_TOKEN="glpat_your_token_here"
 export GITLAB_TEST_PROJECT="123"  # or "myuser/project"
+export GITLAB_BOT_NAME="coding-agent-bot"  # Optional: bot for assignment
 export OPENAI_API_KEY="sk_your_openai_key_here"
 ```
 

tests/real_integration/README.md

@@ -61,11 +61,13 @@ Create a `.env` file or set environment variables:
 # For GitHub testing
 export GITHUB_PERSONAL_ACCESS_TOKEN="ghp_your_token_here"
 export GITHUB_TEST_REPO="yourusername/your-test-repo"
+export GITHUB_BOT_NAME="coding-agent-bot"  # Optional: bot username for assignment
 
 # For GitLab testing
 export GITLAB_PERSONAL_ACCESS_TOKEN="glpat-your_token_here"
 export GITLAB_TEST_PROJECT="123"  # or "yourusername/your-test-project"
 export GITLAB_API_URL="https://gitlab.com/api/v4"
+export GITLAB_BOT_NAME="coding-agent-bot"  # Optional: bot username for assignment
 
 # LLM configuration
 export LLM_PROVIDER="openai"

tests/real_integration/base_framework.py

@@ -48,6 +48,9 @@ def __init__(self, platform: str = "github") -> None:
         # Load configuration
         self.config = self._load_config()
 
+        # Get bot name from environment variables (optional)
+        self.bot_name = self._get_bot_name()
+
     def _check_prerequisites(self) -> None:
         """必要な環境変数が設定されているかをチェックする."""
         if self.platform == "github":
@@ -105,6 +108,19 @@ def _load_config(self) -> dict[str, Any]:
 
         return config
 
+    def _get_bot_name(self) -> str | None:
+        """プラットフォーム固有のボット名を環境変数から取得する.
+
+        Returns:
+            ボット名、または設定されていない場合はNone
+
+        """
+        if self.platform == "github":
+            return os.environ.get("GITHUB_BOT_NAME")
+        if self.platform == "gitlab":
+            return os.environ.get("GITLAB_BOT_NAME")
+        return None
+
     def setup_test_environment(self) -> None:
         """テスト環境をセットアップする."""
         self.logger.info("Setting up test environment for %s", self.platform)
@@ -179,7 +195,7 @@ def create_issue(
             labels = [self.config[self.platform]["bot_label"]]
 
         # これは各プラットフォームで実装されます
-        issue_data = self._create_issue_impl(title, body, labels)
+        issue_data = self._create_issue_impl(title, body, labels, self.bot_name)
 
         # クリーンアップタスクを追加
         def cleanup() -> None:
@@ -192,8 +208,25 @@ def cleanup() -> None:
 
         return issue_data
 
-    def _create_issue_impl(self, title: str, body: str, labels: list[str]) -> dict[str, Any]:
-        """プラットフォーム固有のイシュー作成実装."""
+    def _create_issue_impl(
+        self,
+        title: str,
+        body: str,
+        labels: list[str],
+        assignee: str | None = None,
+    ) -> dict[str, Any]:
+        """プラットフォーム固有のイシュー作成実装.
+
+        Args:
+            title: イシューのタイトル
+            body: イシューの本文
+            labels: ラベルのリスト
+            assignee: アサインするユーザー名(オプション)
+
+        Returns:
+            作成されたイシューの詳細を含む辞書
+
+        """
         msg = "サブクラスは_create_issue_implを実装する必要があります"
         raise NotImplementedError(msg)
 

tests/real_integration/check_config.py

@@ -157,10 +157,24 @@ def main() -> None:
 
     if github_configured:
         checks.append(("GitHub", lambda: True))
+        print("✅ GitHub testing enabled")  # noqa: T201
+        github_bot = os.environ.get("GITHUB_BOT_NAME")
+        if github_bot:
+            print(f"   Bot assignment: {github_bot}")  # noqa: T201
+        else:
+            print("   Bot assignment: Not configured (issues won't be assigned)")  # noqa: T201
+
     if gitlab_configured:
         checks.append(("GitLab", lambda: True))
+        print("✅ GitLab testing enabled")  # noqa: T201
+        gitlab_bot = os.environ.get("GITLAB_BOT_NAME")
+        if gitlab_bot:
+            print(f"   Bot assignment: {gitlab_bot}")  # noqa: T201
+        else:
+            print("   Bot assignment: Not configured (issues won't be assigned)")  # noqa: T201
 
     if not github_configured and not gitlab_configured:
+        print("❌ No platform configured. Please set up GitHub or GitLab credentials.")  # noqa: T201
         sys.exit(1)
 
     # Run remaining checks
@@ -170,8 +184,10 @@ def main() -> None:
             all_passed = False
 
     if all_passed and (github_configured or gitlab_configured):
-        pass
+        print("\n🎉 All configuration checks passed! Ready to run real integration tests.")  # noqa: T201
+        print("Run: python tests/run_tests.py --real")  # noqa: T201
     else:
+        print("\n❌ Some configuration checks failed. Please review your setup.")  # noqa: T201
         sys.exit(1)
 
 

tests/real_integration/github_framework.py

@@ -34,8 +34,25 @@ def __init__(self) -> None:
             "Accept": "application/vnd.github.v3+json",
         }
 
-    def _create_issue_impl(self, title: str, body: str, labels: list[str]) -> dict[str, Any]:
-        """GitHubイシューを作成する."""
+    def _create_issue_impl(
+        self,
+        title: str,
+        body: str,
+        labels: list[str],
+        assignee: str | None = None,
+    ) -> dict[str, Any]:
+        """GitHubイシューを作成する.
+
+        Args:
+            title: イシューのタイトル
+            body: イシューの本文
+            labels: ラベルのリスト
+            assignee: アサインするユーザー名(オプション)
+
+        Returns:
+            作成されたイシューの詳細を含む辞書
+
+        """
         owner, repo = self.test_repo.split("/")
 
         url = f"{self.api_base}/repos/{owner}/{repo}/issues"
@@ -45,12 +62,19 @@ def _create_issue_impl(self, title: str, body: str, labels: list[str]) -> dict[s
             "labels": labels,
         }
 
+        # アサイニーが指定されている場合は追加
+        if assignee:
+            data["assignees"] = [assignee]
+
         response = requests.post(url, json=data, headers=self.headers, timeout=REQUEST_TIMEOUT)
         response.raise_for_status()
 
         issue_data = response.json()
         self.logger.info("Created GitHub issue #%s: %s", issue_data["number"], title)
 
+        if assignee:
+            self.logger.info("Assigned issue #%s to %s", issue_data["number"], assignee)
+
         return issue_data
 
     def _close_issue(self, issue_number: int) -> None:
@@ -153,6 +177,35 @@ def get_latest_pull_request(
         pull_requests = response.json()
         return pull_requests[0] if pull_requests else None
 
+    def assign_pull_request(self, pr_number: int, assignee: str) -> bool:
+        """GitHubプルリクエストにユーザーをアサインする.
+
+        Args:
+            pr_number: プルリクエスト番号
+            assignee: アサインするユーザー名
+
+        Returns:
+            成功した場合True、失敗した場合False
+
+        """
+        if not assignee:
+            return False
+
+        owner, repo = self.test_repo.split("/")
+
+        url = f"{self.api_base}/repos/{owner}/{repo}/issues/{pr_number}/assignees"
+        data = {"assignees": [assignee]}
+
+        try:
+            response = requests.post(url, json=data, headers=self.headers, timeout=REQUEST_TIMEOUT)
+            response.raise_for_status()
+            self.logger.info("Assigned PR #%s to %s", pr_number, assignee)
+        except requests.RequestException as e:
+            self.logger.warning("Failed to assign PR #%s to %s: %s", pr_number, assignee, e)
+            return False
+
+        return True
+
     def _create_label_if_not_exists(self, label: str) -> None:
         """GitHubリポジトリでラベルが存在しない場合は作成する."""
         owner, repo = self.test_repo.split("/")

tests/real_integration/gitlab_framework.py

@@ -31,21 +31,47 @@ def __init__(self) -> None:
             "Content-Type": "application/json",
         }
 
-    def _create_issue_impl(self, title: str, body: str, labels: list[str]) -> dict[str, Any]:
-        """Create a GitLab issue."""
+    def _create_issue_impl(
+        self,
+        title: str,
+        body: str,
+        labels: list[str],
+        assignee: str | None = None,
+    ) -> dict[str, Any]:
+        """GitLabイシューを作成する.
+
+        Args:
+            title: イシューのタイトル
+            body: イシューの本文
+            labels: ラベルのリスト
+            assignee: アサインするユーザー名(オプション)
+
+        Returns:
+            作成されたイシューの詳細を含む辞書
+
+        """
         url = f"{self.api_base}/projects/{self.test_project_id}/issues"
         data = {
             "title": title,
             "description": body,
             "labels": ",".join(labels),
         }
 
+        # アサイニーが指定されている場合はユーザーIDを取得して追加
+        if assignee:
+            assignee_id = self._get_user_id(assignee)
+            if assignee_id:
+                data["assignee_id"] = assignee_id
+
         response = requests.post(url, json=data, headers=self.headers, timeout=REQUEST_TIMEOUT)
         response.raise_for_status()
 
         issue_data = response.json()
         self.logger.info("Created GitLab issue #%s: %s", issue_data["iid"], title)
 
+        if assignee and assignee_id:
+            self.logger.info("Assigned issue #%s to %s", issue_data["iid"], assignee)
+
         return issue_data
 
     def _close_issue(self, issue_iid: int) -> None:
@@ -135,6 +161,64 @@ def get_latest_merge_request(self, source_branch: str | None = None) -> dict[str
         merge_requests = response.json()
         return merge_requests[0] if merge_requests else None
 
+    def _get_user_id(self, username: str) -> int | None:
+        """GitLabユーザー名からユーザーIDを取得する.
+
+        Args:
+            username: GitLabユーザー名
+
+        Returns:
+            ユーザーID、または見つからない場合はNone
+
+        """
+        url = f"{self.api_base}/users"
+        params = {"username": username}
+
+        try:
+            response = requests.get(
+                url, params=params, headers=self.headers, timeout=REQUEST_TIMEOUT,
+            )
+            response.raise_for_status()
+            users = response.json()
+
+            if users:
+                return users[0]["id"]
+        except requests.RequestException as e:
+            self.logger.warning("Failed to get user ID for %s: %s", username, e)
+
+        return None
+
+    def assign_merge_request(self, mr_iid: int, assignee: str) -> bool:
+        """GitLabマージリクエストにユーザーをアサインする.
+
+        Args:
+            mr_iid: マージリクエストのIID
+            assignee: アサインするユーザー名
+
+        Returns:
+            成功した場合True、失敗した場合False
+
+        """
+        if not assignee:
+            return False
+
+        assignee_id = self._get_user_id(assignee)
+        if not assignee_id:
+            return False
+
+        url = f"{self.api_base}/projects/{self.test_project_id}/merge_requests/{mr_iid}"
+        data = {"assignee_id": assignee_id}
+
+        try:
+            response = requests.put(url, json=data, headers=self.headers, timeout=REQUEST_TIMEOUT)
+            response.raise_for_status()
+            self.logger.info("Assigned MR #%s to %s", mr_iid, assignee)
+        except requests.RequestException as e:
+            self.logger.warning("Failed to assign MR #%s to %s: %s", mr_iid, assignee, e)
+            return False
+
+        return True
+
     def _create_label_if_not_exists(self, label: str) -> None:
         """Create a label if it doesn't exist in GitLab project."""
         # Get existing labels

tests/real_test_config_github.yaml

@@ -24,7 +24,7 @@ github:
   processing_label: "coding agent processing"
   done_label: "coding agent done"
   query: 'state:open label:"coding agent"'
-  assignee: "coding-agent-bot"
+  assignee: "${GITHUB_BOT_NAME:-coding-agent-bot}"
 
 max_llm_process_num: 10
 use_rabbitmq: false

tests/real_test_config_gitlab.yaml

@@ -25,7 +25,7 @@ gitlab:
   processing_label: "coding agent processing"
   done_label: "coding agent done"
   query: 'state=opened&labels=coding agent'
-  assignee: "coding-agent-bot"
+  assignee: "${GITLAB_BOT_NAME:-coding-agent-bot}"
 
 max_llm_process_num: 10
 use_rabbitmq: false