gitpadi 2.0.7 → 2.1.2

package/dist/review-and-merge.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+// review-and-merge.ts — Reviews a PR, checks CI, and auto-merges if all pass
+//
+// Usage via Action:  action: review-and-merge
+// Usage via CLI:     npx tsx src/review-and-merge.ts
+import { Octokit } from '@octokit/rest';
+import chalk from 'chalk';
+const TOKEN = process.env.GITHUB_TOKEN || '';
+const OWNER = process.env.GITHUB_OWNER || '';
+const REPO = process.env.GITHUB_REPO || '';
+const PR_NUMBER = parseInt(process.env.PR_NUMBER || '0');
+const AUTO_MERGE = process.env.AUTO_MERGE !== 'false'; // default: true
+const octokit = new Octokit({ auth: TOKEN });
+async function main() {
+    if (!PR_NUMBER) {
+        console.error('❌ PR_NUMBER is required');
+        process.exit(1);
+    }
+    console.log(`\n🤖 GitPadi Review & Merge — ${OWNER}/${REPO} #${PR_NUMBER}\n`);
+    const { data: pr } = await octokit.pulls.get({ owner: OWNER, repo: REPO, pull_number: PR_NUMBER });
+    const checks = [];
+    // ── 1. PR Size Check ──────────────────────────────────────────────
+    const { data: files } = await octokit.pulls.listFiles({ owner: OWNER, repo: REPO, pull_number: PR_NUMBER });
+    const totalChanges = files.reduce((sum, f) => sum + f.additions + f.deletions, 0);
+    if (totalChanges > 1000) {
+        checks.push({ name: 'PR Size', status: '❌', detail: `${totalChanges} lines. Consider splitting.` });
+    }
+    else if (totalChanges > 500) {
+        checks.push({ name: 'PR Size', status: '⚠️', detail: `${totalChanges} lines. Large PR.` });
+    }
+    else {
+        checks.push({ name: 'PR Size', status: '✅', detail: `${totalChanges} lines changed.` });
+    }
+    // ── 2. Linked Issues ──────────────────────────────────────────────
+    const hasIssueRef = /(?:fixes|closes|resolves)\s+#\d+/i.test(pr.body || '');
+    checks.push({
+        name: 'Linked Issues',
+        status: hasIssueRef ? '✅' : '⚠️',
+        detail: hasIssueRef ? 'Issue reference found' : 'No issue reference (Fixes #N)',
+    });
+    // ── 3. Test Files ─────────────────────────────────────────────────
+    const srcFiles = files.filter(f => !f.filename.includes('test') && !f.filename.includes('spec') && (f.filename.endsWith('.ts') || f.filename.endsWith('.rs') || f.filename.endsWith('.js')));
+    const testFiles = files.filter(f => f.filename.includes('test') || f.filename.includes('spec'));
+    if (srcFiles.length > 0 && testFiles.length === 0) {
+        checks.push({ name: 'Test Coverage', status: '⚠️', detail: 'No test files changed.' });
+    }
+    else {
+        checks.push({ name: 'Test Coverage', status: '✅', detail: `${testFiles.length} test file(s) included.` });
+    }
+    // ── 4. CI Status ──────────────────────────────────────────────────
+    const sha = pr.head.sha;
+    const { data: ciChecks } = await octokit.checks.listForRef({ owner: OWNER, repo: REPO, ref: sha });
+    const { data: statuses } = await octokit.repos.getCombinedStatusForRef({ owner: OWNER, repo: REPO, ref: sha });
+    const ciPassed = statuses.state === 'success' || (ciChecks.total_count > 0 && ciChecks.check_runs.every(c => c.conclusion === 'success'));
+    const ciPending = statuses.state === 'pending' || ciChecks.check_runs.some(c => c.status !== 'completed');
+    const ciFailed = statuses.state === 'failure' || ciChecks.check_runs.some(c => c.conclusion === 'failure');
+    if (ciFailed) {
+        const failedNames = ciChecks.check_runs.filter(c => c.conclusion === 'failure').map(c => c.name).join(', ');
+        checks.push({ name: 'CI Status', status: '❌', detail: `Failed: ${failedNames || 'status checks'}` });
+    }
+    else if (ciPending) {
+        checks.push({ name: 'CI Status', status: '⚠️', detail: 'CI is still running...' });
+    }
+    else {
+        checks.push({ name: 'CI Status', status: '✅', detail: 'All checks passed.' });
+    }
+    // ── Build Review Comment ──────────────────────────────────────────
+    const hasCritical = checks.some(c => c.status === '❌');
+    const hasWarning = checks.some(c => c.status === '⚠️');
+    const headerEmoji = hasCritical ? '🚨' : hasWarning ? '⚠️' : '✅';
+    let body = `## ${headerEmoji} GitPadi — Automated PR Review\n\n`;
+    body += `| Check | Status | Details |\n|-------|--------|--------|\n`;
+    checks.forEach(c => { body += `| ${c.name} | ${c.status} | ${c.detail} |\n`; });
+    body += `\n`;
+    if (ciFailed) {
+        body += `> 🚨 **CI Failed.** Please fix the failing checks and push again. Use \`gitpadi\` → \`Fix & Re-push\` for a guided workflow.\n`;
+    }
+    else if (hasCritical) {
+        body += `> 🚨 **Action Required:** Critical issues found. Please address before merging.\n`;
+    }
+    else if (ciPassed && !hasCritical) {
+        body += `> ✅ **All checks passed.** ${AUTO_MERGE ? 'Auto-merging...' : 'Ready for manual merge.'}\n`;
+    }
+    body += `\n---\n_Review by [GitPadi](https://github.com/Netwalls/contributor-agent) 🤖_`;
+    // Post the review comment
+    await octokit.issues.createComment({ owner: OWNER, repo: REPO, issue_number: PR_NUMBER, body });
+    console.log('✅ Posted review comment');
+    // ── Auto-Merge Logic ──────────────────────────────────────────────
+    if (ciPassed && !hasCritical && AUTO_MERGE) {
+        console.log('🔀 CI passed. Attempting auto-merge...');
+        try {
+            await octokit.pulls.merge({
+                owner: OWNER, repo: REPO, pull_number: PR_NUMBER,
+                merge_method: 'squash',
+                commit_title: `${pr.title} (#${PR_NUMBER})`,
+            });
+            console.log(chalk.green(`✅ PR #${PR_NUMBER} merged successfully!`));
+            // Close any linked issues (handles non-default-branch merges too)
+            const issueRefs = (pr.body || '').matchAll(/(?:fixes|closes|resolves)\s+#(\d+)/gi);
+            for (const match of issueRefs) {
+                const issueNumber = parseInt(match[1]);
+                try {
+                    await octokit.issues.update({ owner: OWNER, repo: REPO, issue_number: issueNumber, state: 'closed' });
+                    await octokit.issues.createComment({
+                        owner: OWNER, repo: REPO, issue_number: issueNumber,
+                        body: `✅ Closed by PR #${PR_NUMBER} — merged via GitPadi 🤖`,
+                    });
+                    console.log(`✅ Closed linked issue #${issueNumber}`);
+                }
+                catch {
+                    console.log(`⚠️ Could not close issue #${issueNumber}`);
+                }
+            }
+        }
+        catch (e) {
+            console.log(chalk.yellow(`⚠️ Auto-merge failed: ${e.message}`));
+        }
+    }
+    else if (ciFailed) {
+        console.log(chalk.red(`❌ CI failed. Contributor notified to fix.`));
+        process.exit(1);
+    }
+    checks.forEach(c => console.log(`  ${c.status} ${c.name}: ${c.detail}`));
+}
+main().catch((e) => { console.error('Fatal:', e); process.exit(1); });

package/examples/gitpadi.yml

@@ -0,0 +1,152 @@
+# ─────────────────────────────────────────────────────────────────────────────
+#  GitPadi — Drop-in GitHub Automation
+#  Copy this file to .github/workflows/gitpadi.yml in your repo.
+#
+#  What this does automatically:
+#    ✅ Reviews every PR (size, tests, security, linked issues)
+#    ✅ Scores contributors when they apply on issues + assigns the best one
+#    ✅ Sends escalating reminders for stale PRs (24h → 48h → 72h)
+#    ✅ Grades assignment submissions and auto-merges passing ones
+#    ✅ Closes linked issues when PRs are merged
+#
+#  Optional manual triggers:
+#    - Bulk create issues from a JSON/MD file
+#    - Force review-and-merge any PR
+#
+#  Setup:
+#    No secrets needed — uses the built-in GITHUB_TOKEN.
+#    For assignment grading, set GITPADI_ASSIGNMENT_MODE: true (see below).
+# ─────────────────────────────────────────────────────────────────────────────
+
+name: GitPadi
+
+on:
+  # Fires on every PR open, update, or reopen
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+  # Fires when someone comments on an issue (contributor applications)
+  issue_comment:
+    types: [created]
+
+  # Fires daily at 9am UTC — sends reminders for stale PRs
+  schedule:
+    - cron: '0 9 * * *'
+
+  # Manual triggers — run from Actions tab
+  workflow_dispatch:
+    inputs:
+      action:
+        description: 'Action to run manually'
+        required: true
+        type: choice
+        options:
+          - review-and-merge
+          - create-issues
+          - remind-contributors
+      pr_number:
+        description: 'PR number (for review-and-merge)'
+        required: false
+      issues_file:
+        description: 'Path to issues file (for create-issues)'
+        required: false
+        default: 'issues.json'
+
+permissions:
+  contents: write        # needed to merge PRs
+  issues: write          # needed to assign, close, comment on issues
+  pull-requests: write   # needed to review and comment on PRs
+
+jobs:
+
+  # ── Review every PR ──────────────────────────────────────────────────────
+  review-pr:
+    name: Review PR
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Netwalls/contributor-agent@main
+        with:
+          action: review-pr
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+  # ── Grade assignment PRs (only if GITPADI_ASSIGNMENT_MODE is enabled) ───
+  # To enable: add GITPADI_ASSIGNMENT_MODE = true to your repo Variables
+  # (Settings → Secrets and variables → Actions → Variables)
+  grade-assignment:
+    name: Grade Assignment
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'pull_request' &&
+      vars.GITPADI_ASSIGNMENT_MODE == 'true'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Netwalls/contributor-agent@main
+        with:
+          action: grade-assignment
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          pass-threshold: '40'    # score out of 100 needed to auto-merge
+          auto-merge: 'true'
+
+  # ── Score contributors when they apply on issues ─────────────────────────
+  # Triggered when someone comments "I want to work on this" (or similar)
+  # on any issue. Scores applicant + auto-assigns the best candidate.
+  score-applicant:
+    name: Score Contributor
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'issue_comment' &&
+      github.event.issue.pull_request == null
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Netwalls/contributor-agent@main
+        with:
+          action: score-applicant
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          # Uncomment to notify a maintainer on every new applicant:
+          # notify-user: 'your-github-username'
+
+  # ── Daily reminders for stale PRs ────────────────────────────────────────
+  remind-contributors:
+    name: Remind Contributors
+    runs-on: ubuntu-latest
+    if: github.event_name == 'schedule'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Netwalls/contributor-agent@main
+        with:
+          action: remind-contributors
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+  # ── Manual: review + merge a specific PR ─────────────────────────────────
+  review-and-merge:
+    name: Review & Merge PR
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'workflow_dispatch' &&
+      github.event.inputs.action == 'review-and-merge'
+    env:
+      PR_NUMBER: ${{ github.event.inputs.pr_number }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Netwalls/contributor-agent@main
+        with:
+          action: review-and-merge
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          auto-merge: 'true'
+
+  # ── Manual: bulk create issues from a file ───────────────────────────────
+  create-issues:
+    name: Create Issues
+    runs-on: ubuntu-latest
+    if: |
+      github.event_name == 'workflow_dispatch' &&
+      github.event.inputs.action == 'create-issues'
+    steps:
+      - uses: actions/checkout@v4
+      - uses: Netwalls/contributor-agent@main
+        with:
+          action: create-issues
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          issues-file: ${{ github.event.inputs.issues_file }}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "gitpadi",
-    "version": "2.0.7",
-    "description": "GitPadi — Your AI-powered GitHub management CLI. Create repos, manage issues & PRs, score contributors, and automate everything.",
+    "version": "2.1.2",
+    "description": "GitPadi — AI-powered GitHub & GitLab management CLI. Fork repos, manage issues & PRs, score contributors, grade assignments, and automate everything. Powered by Anthropic Claude via GitLab Duo Agent Platform.",
     "type": "module",
     "bin": {
         "gitpadi": "./dist/cli.js"
@@ -10,6 +10,8 @@
         "dist/",
         "src/",
         "action.yml",
+        ".gitlab-ci.yml",
+        ".gitlab/",
         "examples/",
         "README.md",
         "LICENSE"
@@ -21,21 +23,35 @@
         "dev": "tsx watch src/cli.ts",
         "create-issues": "tsx src/create-issues.ts",
         "review-pr": "tsx src/pr-review.ts",
-        "score-applicant": "tsx src/applicant-scorer.ts"
+        "score-applicant": "tsx src/applicant-scorer.ts",
+        "grade-assignment": "tsx src/grade-assignment.ts",
+        "gl:score": "tsx src/gitlab-agents/contributor-scoring-agent.ts",
+        "gl:review": "tsx src/gitlab-agents/mr-review-agent.ts",
+        "gl:recover": "tsx src/gitlab-agents/ci-recovery-agent.ts",
+        "gl:remind": "tsx src/gitlab-agents/reminder-agent.ts",
+        "gl:grade": "tsx src/gitlab-agents/grade-assignment-agent.ts"
     },
     "keywords": [
         "github",
+        "gitlab",
         "cli",
         "github-action",
+        "gitlab-ci",
         "issue-management",
         "pr-review",
+        "merge-request",
         "contributor-scoring",
         "automation",
+        "ai-agent",
+        "anthropic",
+        "claude",
+        "gitlab-duo",
         "gitpadi"
     ],
     "author": "Netwalls",
     "license": "MIT",
     "dependencies": {
+        "@anthropic-ai/sdk": "^0.40.1",
         "@octokit/rest": "^21.1.1",
         "boxen": "^8.0.1",
         "chalk": "^5.4.1",
@@ -52,4 +68,4 @@
         "@types/node": "^22.10.5",
         "typescript": "^5.9.3"
     }
-}
+}

package/src/applicant-scorer.ts

@@ -6,7 +6,14 @@
 // Usage via Action:  action: score-applicant
 // Usage (CLI):       GITHUB_TOKEN=xxx ISSUE_NUMBER=5 COMMENT_ID=123 npx tsx src/applicant-scorer.ts
 
-import { Octokit } from '@octokit/rest';
+import { initGitHub, getOctokit } from './core/github.js';
+import {
+    isApplicationComment,
+    fetchProfile,
+    scoreApplicant,
+    TIER_EMOJI,
+    type ScoredApplicant,
+} from './core/scorer.js';
 
 // ── Config ─────────────────────────────────────────────────────────────
 const GITHUB_TOKEN = process.env.GITHUB_TOKEN!;
@@ -18,148 +25,10 @@ const NOTIFY_USER = process.env.NOTIFY_USER || '';
 
 if (!GITHUB_TOKEN) { console.error('❌ GITHUB_TOKEN required'); process.exit(1); }
 
-const octokit = new Octokit({ auth: GITHUB_TOKEN });
-
-// ── Application Detection ──────────────────────────────────────────────
-const APPLICATION_PATTERNS = [
-    /i('d| would) (like|love|want) to (work on|tackle|take|pick up|handle)/i,
-    /can i (work on|take|pick up|handle|be assigned)/i,
-    /assign (this |it )?(to )?me/i,
-    /i('m| am) interested/i,
-    /let me (work on|take|handle)/i,
-    /i('ll| will) (work on|take|handle|do)/i,
-    /i want to contribute/i,
-    /please assign/i,
-    /i can (do|handle|take care of|work on)/i,
-    /picking this up/i,
-    /claiming this/i,
-];
-
-function isApplicationComment(body: string): boolean {
-    return APPLICATION_PATTERNS.some((p) => p.test(body));
-}
-
-// ── Types ──────────────────────────────────────────────────────────────
-interface ApplicantProfile {
-    username: string;
-    avatarUrl: string;
-    accountAge: number;
-    publicRepos: number;
-    followers: number;
-    totalContributions: number;
-    repoContributions: number;
-    relevantLanguages: string[];
-    hasReadme: boolean;
-    prsMerged: number;
-    prsOpen: number;
-    issuesCreated: number;
-    commentBody: string;
-}
-
-interface ScoreBreakdown {
-    accountMaturity: number;   // 0-15
-    repoExperience: number;   // 0-30
-    githubPresence: number;   // 0-15
-    activityLevel: number;    // 0-15
-    applicationQuality: number; // 0-15
-    languageRelevance: number; // 0-10
-    total: number;
-}
-
-interface ScoredApplicant extends ApplicantProfile {
-    score: number;
-    breakdown: ScoreBreakdown;
-    tier: 'S' | 'A' | 'B' | 'C' | 'D';
-}
-
-// ── Fetch Profile ──────────────────────────────────────────────────────
-async function fetchProfile(username: string, commentBody: string): Promise<ApplicantProfile> {
-    const { data: user } = await octokit.users.getByUsername({ username });
-    const accountAge = Math.floor((Date.now() - new Date(user.created_at).getTime()) / 86400000);
-
-    let totalContributions = 0;
-    try {
-        const { data: events } = await octokit.activity.listPublicEventsForUser({ username, per_page: 100 });
-        totalContributions = events.length;
-    } catch { /* continue */ }
-
-    let prsMerged = 0, prsOpen = 0, issuesCreated = 0;
-    try {
-        const { data: mp } = await octokit.search.issuesAndPullRequests({ q: `repo:${OWNER}/${REPO} type:pr author:${username} is:merged` });
-        prsMerged = mp.total_count;
-        const { data: op } = await octokit.search.issuesAndPullRequests({ q: `repo:${OWNER}/${REPO} type:pr author:${username} is:open` });
-        prsOpen = op.total_count;
-        const { data: ci } = await octokit.search.issuesAndPullRequests({ q: `repo:${OWNER}/${REPO} type:issue author:${username}` });
-        issuesCreated = ci.total_count;
-    } catch { /* rate limit */ }
-
-    let relevantLanguages: string[] = [];
-    try {
-        const { data: repos } = await octokit.repos.listForUser({ username, sort: 'updated', per_page: 20 });
-        const langs = new Set<string>();
-        repos.forEach((r) => { if (r.language) langs.add(r.language); });
-        relevantLanguages = Array.from(langs);
-    } catch { /* continue */ }
-
-    let hasReadme = false;
-    try { await octokit.repos.get({ owner: username, repo: username }); hasReadme = true; } catch { /* no readme */ }
-
-    return {
-        username, avatarUrl: user.avatar_url, accountAge,
-        publicRepos: user.public_repos, followers: user.followers,
-        totalContributions, repoContributions: prsMerged + prsOpen + issuesCreated,
-        relevantLanguages, hasReadme, prsMerged, prsOpen, issuesCreated, commentBody,
-    };
-}
-
-// ── Scoring Algorithm ──────────────────────────────────────────────────
-function scoreApplicant(p: ApplicantProfile, issueLabels: string[]): ScoredApplicant {
-    const b: ScoreBreakdown = { accountMaturity: 0, repoExperience: 0, githubPresence: 0, activityLevel: 0, applicationQuality: 0, languageRelevance: 0, total: 0 };
-
-    // 1. Account Maturity (0-15)
-    b.accountMaturity = p.accountAge > 730 ? 15 : p.accountAge > 365 ? 12 : p.accountAge > 180 ? 9 : p.accountAge > 90 ? 6 : p.accountAge > 30 ? 3 : 1;
-
-    // 2. Repo Experience (0-30) — highest weight
-    b.repoExperience = Math.min(15, p.prsMerged * 5) + Math.min(5, p.prsOpen * 3) + Math.min(5, p.issuesCreated * 2) + Math.min(5, p.repoContributions);
-
-    // 3. GitHub Presence (0-15)
-    b.githubPresence = Math.min(5, Math.floor(p.publicRepos / 5)) + Math.min(5, Math.floor(p.followers / 10)) + (p.hasReadme ? 5 : 0);
-
-    // 4. Activity Level (0-15)
-    b.activityLevel = p.totalContributions >= 80 ? 15 : p.totalContributions >= 50 ? 12 : p.totalContributions >= 30 ? 9 : p.totalContributions >= 15 ? 6 : p.totalContributions >= 5 ? 3 : 1;
-
-    // 5. Application Quality (0-15)
-    const words = p.commentBody.split(/\s+/).length;
-    const hasApproach = /approach|plan|implement|would|will|by|using|step/i.test(p.commentBody);
-    const hasExp = /experience|worked|built|familiar|know|background/i.test(p.commentBody);
-    b.applicationQuality = (words >= 50 && hasApproach && hasExp) ? 15 : (words >= 30 && (hasApproach || hasExp)) ? 12 : (words >= 20 && hasApproach) ? 9 : words >= 15 ? 6 : words >= 8 ? 3 : 1;
-
-    // 6. Language Relevance (0-10) — auto-detect from repo languages
-    b.languageRelevance = 5; // default neutral
-    if (issueLabels.length > 0 && p.relevantLanguages.length > 0) {
-        // Approximate: check if user knows popular labels' likely languages
-        const labelLower = issueLabels.map((l) => l.toLowerCase()).join(' ');
-        const hasRust = p.relevantLanguages.includes('Rust');
-        const hasTS = p.relevantLanguages.includes('TypeScript') || p.relevantLanguages.includes('JavaScript');
-        const needsRust = /contract|rust|wasm|soroban/i.test(labelLower);
-        const needsTS = /backend|frontend|api|websocket|typescript/i.test(labelLower);
-
-        let matches = 0, needed = 0;
-        if (needsRust) { needed++; if (hasRust) matches++; }
-        if (needsTS) { needed++; if (hasTS) matches++; }
-        if (needed > 0) b.languageRelevance = Math.round((matches / needed) * 10);
-    }
-
-    b.total = b.accountMaturity + b.repoExperience + b.githubPresence + b.activityLevel + b.applicationQuality + b.languageRelevance;
-
-    const tier: ScoredApplicant['tier'] = b.total >= 75 ? 'S' : b.total >= 55 ? 'A' : b.total >= 40 ? 'B' : b.total >= 25 ? 'C' : 'D';
-
-    return { ...p, score: b.total, breakdown: b, tier };
-}
+// Initialise shared GitHub client so core/scorer.ts functions work
+initGitHub(GITHUB_TOKEN, OWNER, REPO);
 
 // ── Build Comments ─────────────────────────────────────────────────────
-const TIER_EMOJI: Record<string, string> = { S: '🏆', A: '🟢', B: '🟡', C: '🟠', D: '🔴' };
-
 function buildReviewComment(s: ScoredApplicant, count: number): string {
     let c = `## 🤖 Contributor Agent — Applicant Review\n\n`;
     c += `**Applicant:** @${s.username} ${TIER_EMOJI[s.tier]} **Tier ${s.tier}** (${s.score}/100)\n\n`;
@@ -214,6 +83,8 @@ async function main(): Promise<void> {
     console.log(`\n🤖 Applicant Scorer — ${OWNER}/${REPO} #${ISSUE_NUMBER}\n`);
     if (!ISSUE_NUMBER) { console.error('❌ ISSUE_NUMBER required'); process.exit(1); }
 
+    const octokit = getOctokit();
+
     // Get trigger comment
     let trigger: { body: string; user: string };
     if (COMMENT_ID) {
@@ -280,6 +151,27 @@ async function main(): Promise<void> {
         }
         console.log(`✅ Comparison posted (${allScored.length} candidates)\n`);
     }
+
+    // Auto-assign the top-scoring S or A tier candidate
+    const sorted = [...allScored].sort((a, b) => b.score - a.score);
+    const top = sorted[0];
+    if (top && (top.tier === 'S' || top.tier === 'A')) {
+        // Only assign if the issue has no assignees yet
+        const currentAssignees = issue.assignees?.map((a) => a.login) || [];
+        if (currentAssignees.length === 0) {
+            await octokit.issues.addAssignees({
+                owner: OWNER,
+                repo: REPO,
+                issue_number: ISSUE_NUMBER,
+                assignees: [top.username],
+            });
+            console.log(`✅ Auto-assigned @${top.username} to issue #${ISSUE_NUMBER} (Tier ${top.tier}, ${top.score}/100)`);
+        } else {
+            console.log(`ℹ️ Issue already assigned to: ${currentAssignees.join(', ')} — skipping auto-assign`);
+        }
+    } else if (top) {
+        console.log(`ℹ️ Top candidate @${top.username} is Tier ${top.tier} (${top.score}/100) — below auto-assign threshold (S/A)`);
+    }
 }
 
 main().catch((e) => { console.error('Fatal:', e); process.exit(1); });