feat: add auto assign beginner auto

Signed-off-by: exploreriii <133720349+exploreriii@users.noreply.github.com>

Author: exploreriii

.github/scripts/bots/assign-beginner-auto.js

@@ -0,0 +1,152 @@
+/**
+ * Auto-assigns a Beginner issue when a user comments `/assign`.
+ *
+ * Architecture:
+ * - Policy lives in lib/eligibility/*
+ * - Messaging lives in lib/comments/*
+ * - This file only orchestrates
+ */
+
+const { isTeam } =
+    require('../lib/team/has-team');
+
+const { hasBeginnerEligibility } =
+    require('../lib/eligibility/has-eligibility-02-beginner');
+
+const { rejectionRouter } =
+    require('../lib/comments/rejection-router');
+
+const { assignReminder } =
+    require('../lib/comments/reminder-to-request-assign');
+
+const { alreadyAssigned } =
+    require('../lib/comments/issue-already-assigned');
+
+const BEGINNER_LABEL = 'beginner';
+const ASSIGN_REMINDER_MARKER = '<!-- Beginner assign reminder -->';
+
+const BROWSE_URLS = {
+    gfi: 'https://github.com/hiero-ledger/hiero-sdk-python/issues?q=is%3Aissue+state%3Aopen+label%3A"Good+First+Issue"+no%3Aassignee',
+    beginner: 'https://github.com/hiero-ledger/hiero-sdk-python/issues?q=is%3Aissue+state%3Aopen+label%3Abeginner+no%3Aassignee',
+};
+
+function requestsAssignment(body) {
+    return typeof body === 'string' && /(^|\s)\/assign(\s|$)/i.test(body);
+}
+
+function isBeginnerIssue(issue) {
+    return (issue.labels ?? []).some(l => l.name === BEGINNER_LABEL);
+}
+
+module.exports = async ({ github, context }) => {
+    const { issue, comment } = context.payload;
+    const { owner, repo } = context.repo;
+
+    if (!issue || !comment) return;
+    if (comment.user?.type === 'Bot') return;
+    if (!isBeginnerIssue(issue)) return;
+
+    const username = comment.user.login;
+
+    console.log('[beginner-assign] Start', {
+        issue: issue.number,
+        username,
+    });
+
+    // ─────────────────────────────────────────────
+    // Gentle reminder if user comments but not /assign
+    // ─────────────────────────────────────────────
+    if (!requestsAssignment(comment.body)) {
+        if (
+            !issue.assignees?.length &&
+            !(await isTeam({ github, owner, repo, username }))
+        ) {
+            const comments = await github.paginate(
+                github.rest.issues.listComments,
+                { owner, repo, issue_number: issue.number, per_page: 100 }
+            );
+
+            const alreadyReminded = comments.some(c =>
+                c.body?.includes(ASSIGN_REMINDER_MARKER)
+            );
+
+            if (!alreadyReminded) {
+                await github.rest.issues.createComment({
+                    owner,
+                    repo,
+                    issue_number: issue.number,
+                    body:
+                        ASSIGN_REMINDER_MARKER +
+                        assignReminder(username, 'Beginner'),
+                });
+
+                console.log('[beginner-assign] Posted assign reminder');
+            }
+        }
+
+        return;
+    }
+
+    // ─────────────────────────────────────────────
+    // Already assigned
+    // ─────────────────────────────────────────────
+    if (issue.assignees?.length) {
+        await github.rest.issues.createComment({
+            owner,
+            repo,
+            issue_number: issue.number,
+            body: alreadyAssigned({
+                username,
+                assignee: `@${issue.assignees[0].login}`,
+                browseUrl: BROWSE_URLS.beginner,
+                tierLabel: 'Beginner',
+            }),
+        });
+        return;
+    }
+
+    // ─────────────────────────────────────────────
+    // Eligibility check (POLICY)
+    // ─────────────────────────────────────────────
+    const result = await hasBeginnerEligibility({
+        github,
+        owner,
+        repo,
+        username,
+    });
+
+    if (!result.eligible) {
+        const body = rejectionRouter({
+            reason: result.reason,
+            context: result.context,
+            username,
+            urls: BROWSE_URLS,
+        });
+
+        if (body) {
+            await github.rest.issues.createComment({
+                owner,
+                repo,
+                issue_number: issue.number,
+                body,
+            });
+        }
+
+        return;
+    }
+
+    // ─────────────────────────────────────────────
+    // Assign issue
+    // ─────────────────────────────────────────────
+    await github.rest.issues.addAssignees({
+        owner,
+        repo,
+        issue_number: issue.number,
+        assignees: [username],
+    });
+
+    console.log('[beginner-assign] Assigned successfully', {
+        issue: issue.number,
+        username,
+    });
+};

.github/scripts/lib/comments/rejection-router.js

@@ -0,0 +1,32 @@
+const { beginnerRejection } = require('./difficulty-02-beginner');
+const { capacityLimitReached } = require('./max-assignments-reached');
+const { spamNonGfiAssignment } = require('./spam-restrictions');
+
+const REJECTION_REASONS =
+    require('../eligibility/rejection-reasons');
+
+const rejectionRouter = ({ reason, context, username, urls }) => {
+    switch (reason) {
+        case REJECTION_REASONS.MISSING_GFI:
+            return beginnerRejection({
+                username,
+                completedGfiCount: context.completedGfiCount,
+                browseGfiUrl: urls.gfi,
+            });
+
+        case REJECTION_REASONS.CAPACITY:
+            return capacityLimitReached({
+                username,
+                openAssignedCount: context.openAssignedCount,
+                maxAllowed: context.maxAllowed,
+            });
+
+        case REJECTION_REASONS.SPAM:
+            return spamNonGfiAssignment(username);
+
+        default:
+            return null;
+    }
+};
+
+module.exports = { rejectionRouter };

.github/scripts/lib/eligibility/rejection-reasons.js

@@ -0,0 +1,6 @@
+// lib/eligibility/rejection-reasons.js
+module.exports = {
+    MISSING_GFI: 'missing_gfi',
+    CAPACITY: 'capacity_exceeded',
+    SPAM: 'spam_listed',
+};