feat: Add automated assignment limit bot (#960)

Signed-off-by: Adityarya11 <arya050411@gmail.com>
Signed-off-by: notsogod <149138960+Adityarya11@users.noreply.github.com>

Author: Adityarya11

.github/scripts/check_assignment_limit.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+if [ -z "$ASSIGNEE" ] || [ -z "$ISSUE_NUMBER" ] || [ -z "$REPO" ]; then
+  echo "Error: Missing required environment variables (ASSIGNEE, ISSUE_NUMBER, REPO)."
+  exit 1
+fi
+
+echo "Checking assignment rules for user $ASSIGNEE on issue #$ISSUE_NUMBER"
+
+PERM_JSON=$(gh api repos/$REPO/collaborators/$ASSIGNEE/permission)
+PERMISSION=$(echo "$PERM_JSON" | jq -r '.permission')
+
+echo "User permission level: $PERMISSION"
+
+if [[ "$PERMISSION" == "admin" ]] || [[ "$PERMISSION" == "write" ]]; then
+  echo "User is a maintainer or committer. Limit does not apply."
+  exit 0
+fi
+
+ASSIGNMENTS_JSON=$(gh issue list --repo $REPO --assignee "$ASSIGNEE" --state open --json number)
+COUNT=$(echo "$ASSIGNMENTS_JSON" | jq '. | length')
+
+echo "Current open assignments count: $COUNT"
+
+if (( COUNT > 2 )); then
+  echo "Limit exceeded (Max 2 allowed). Revoking assignment."
+
+  gh issue edit $ISSUE_NUMBER --repo $REPO --remove-assignee "$ASSIGNEE"
+
+  MSG="Hi @$ASSIGNEE, this is the Assignment Bot."
+  MSG="$MSG\n\nAssigning you to this issue would exceed the limit of 2 open assignments."
+  MSG="$MSG\n\nPlease resolve and merge your existing assigned issues before requesting new ones."
+
+  gh issue comment $ISSUE_NUMBER --repo $REPO --body "$(printf "$MSG")"
+  
+  exit 1
+else
+  echo "Assignment valid. User has $COUNT assignments."
+fi

.github/workflows/bot-assignment-check.yml

@@ -0,0 +1,33 @@
+name: PythonBot - Assignment Limit
+
+on:
+  issues:
+    types: [assigned]
+
+permissions:
+  issues: write
+
+jobs:
+  check-assignment-limit:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Harden the runner
+        uses: step-security/harden-runner@95d9a5deda9de15063e7595e9719c11c38c90ae2 # v2.13.2
+        with:
+          egress-policy: audit
+
+      - name: Checkout repository
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8  # v6.0.1
+
+      - name: Check Assignment Count
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          ASSIGNEE: ${{ github.event.assignee.login }}
+          ISSUE_NUMBER: ${{ github.event.issue.number }}
+          REPO: ${{ github.repository }}
+        run: |
+          # Make script executable (just in case permissions were lost during checkout)
+          chmod +x .github/scripts/check_assignment_limit.sh
+          
+          # Run the script
+          ./.github/scripts/check_assignment_limit.sh

CHANGELOG.md

@@ -7,21 +7,25 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 ## [Unreleased]
 
 ### Added
+
+- Added `.github/workflows/bot-assignment-check.yml` to limit non-maintainers to 2 concurrent issue assignments.
 - Add examples/tokens/token_create_transaction_pause_key.py example demonstrating token pause/unpause behavior and pause key usage (#833)
 - Added `docs/sdk_developers/training/transaction_lifecycle.md` to explain the typical lifecycle of executing a transaction using the Hedera Python SDK.
 - Add inactivity bot workflow to unassign stale issue assignees (#952)
 ### Changed
--
 
 ### Fixed
+
 -
 
 ### Breaking Change
+
 -
 
 ## [0.1.10] - 2025-12-03
 
 ### Added
+
 - Added docs/sdk_developers/training/workflow: a training for developers to learn the workflow to contribute to the python SDK.
 - Added Improved NFT allowance deletion flow with receipt-based status checks and strict `SPENDER_DOES_NOT_HAVE_ALLOWANCE` verification.
 - Add `max_automatic_token_associations`, `staked_account_id`, `staked_node_id` and `decline_staking_reward` fields to `AccountUpdateTransaction` (#801)
@@ -41,7 +45,6 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - feat: Add string representation method for `CustomFractionalFee` class and update `custom_fractional_fee.py` example.
 - Moved query examples to their respective domain folders to improve structure matching.
 
-
 ### Fixed
 
 - fixed workflow: changelog check with improved sensitivity to deletions, additions, new releases