gitpadi 2.0.0

package/src/applicant-scorer.ts

@@ -0,0 +1,285 @@
+#!/usr/bin/env tsx
+// applicant-scorer.ts — Detects issue applicants, scores them, and recommends the best fit
+//
+// Works for ANY repository — no hardcoded values.
+//
+// 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';
+
+// ── Config ─────────────────────────────────────────────────────────────
+const GITHUB_TOKEN = process.env.GITHUB_TOKEN!;
+const OWNER = process.env.GITHUB_OWNER || process.env.GITHUB_REPOSITORY?.split('/')[0] || '';
+const REPO = process.env.GITHUB_REPO || process.env.GITHUB_REPOSITORY?.split('/')[1] || '';
+const ISSUE_NUMBER = parseInt(process.env.ISSUE_NUMBER || '0');
+const COMMENT_ID = parseInt(process.env.COMMENT_ID || '0');
+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 };
+}
+
+// ── 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`;
+    c += `<details>\n<summary>📊 Score Breakdown</summary>\n\n`;
+    c += `| Category | Score | Max |\n|----------|-------|-----|\n`;
+    c += `| 🏛️ Account Maturity | ${s.breakdown.accountMaturity} | 15 |\n`;
+    c += `| 🔧 Repo Experience | ${s.breakdown.repoExperience} | 30 |\n`;
+    c += `| 🌐 GitHub Presence | ${s.breakdown.githubPresence} | 15 |\n`;
+    c += `| ⚡ Activity Level | ${s.breakdown.activityLevel} | 15 |\n`;
+    c += `| 📝 Application Quality | ${s.breakdown.applicationQuality} | 15 |\n`;
+    c += `| 💻 Language Relevance | ${s.breakdown.languageRelevance} | 10 |\n`;
+    c += `| **Total** | **${s.score}** | **100** |\n\n`;
+    c += `**Profile:** ${s.publicRepos} repos · ${s.followers} followers · ${Math.round(s.accountAge / 30)} months\n`;
+    c += `**Languages:** ${s.relevantLanguages.slice(0, 8).join(', ') || 'None detected'}\n`;
+    c += `**Repo history:** ${s.prsMerged} merged PRs · ${s.prsOpen} open PRs · ${s.issuesCreated} issues\n\n`;
+    c += `</details>\n\n`;
+
+    if (s.tier === 'S' || s.tier === 'A') c += `> ✅ **Strong candidate.** Consider assigning.\n`;
+    else if (s.tier === 'B') c += `> 🟡 **Decent candidate.** Review profile before assigning.\n`;
+    else c += `> ⚠️ **Low score.** Wait for stronger candidates or review manually.\n`;
+
+    if (count > 1) c += `\n📋 **${count} applicant(s)** — see comparison below.\n`;
+    if (NOTIFY_USER) c += `\n🔔 cc @${NOTIFY_USER}\n`;
+    c += `\n---\n<sub>🤖 Contributor Agent · Tier ${s.tier} · ${s.score}/100</sub>`;
+    return c;
+}
+
+function buildComparisonComment(applicants: ScoredApplicant[]): string {
+    const sorted = [...applicants].sort((a, b) => b.score - a.score);
+    let c = `## 🤖 Contributor Agent — Applicant Comparison\n\n`;
+    c += `| Rank | Applicant | Tier | Score | Repo PRs | Languages | Activity |\n`;
+    c += `|------|-----------|------|-------|----------|-----------|----------|\n`;
+    sorted.forEach((a, i) => {
+        const medal = i === 0 ? '🥇' : i === 1 ? '🥈' : i === 2 ? '🥉' : `${i + 1}.`;
+        c += `| ${medal} | @${a.username} | ${TIER_EMOJI[a.tier]} ${a.tier} | **${a.score}**/100 | ${a.prsMerged} merged | ${a.relevantLanguages.slice(0, 3).join(', ') || '-'} | ${a.totalContributions} events |\n`;
+    });
+
+    if (sorted.length >= 2) {
+        const gap = sorted[0].score - sorted[1].score;
+        if (gap >= 20) c += `\n> 🏆 **Clear winner:** @${sorted[0].username} leads by ${gap} points.\n`;
+        else if (gap >= 5) c += `\n> 🏆 **Top pick:** @${sorted[0].username} leads by ${gap} points.\n`;
+        else c += `\n> ⚖️ **Close match:** Top candidates within ${gap} points. Manual review recommended.\n`;
+    }
+
+    if (NOTIFY_USER) c += `\n🔔 cc @${NOTIFY_USER}\n`;
+    c += `\n---\n<sub>🤖 Contributor Agent · ${sorted.length} candidates ranked</sub>`;
+    return c;
+}
+
+// ── Main ───────────────────────────────────────────────────────────────
+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); }
+
+    // Get trigger comment
+    let trigger: { body: string; user: string };
+    if (COMMENT_ID) {
+        const { data: c } = await octokit.issues.getComment({ owner: OWNER, repo: REPO, comment_id: COMMENT_ID });
+        trigger = { body: c.body || '', user: c.user?.login || '' };
+    } else {
+        const { data: cs } = await octokit.issues.listComments({ owner: OWNER, repo: REPO, issue_number: ISSUE_NUMBER, per_page: 1, direction: 'desc' });
+        if (!cs.length) { console.log('No comments.'); return; }
+        trigger = { body: cs[0].body || '', user: cs[0].user?.login || '' };
+    }
+
+    console.log(`  Commenter: ${trigger.user}`);
+    if (!isApplicationComment(trigger.body)) { console.log('\n⏭️ Not an application — skipping.'); return; }
+    console.log('✅ Application detected!\n');
+
+    // Get issue labels
+    const { data: issue } = await octokit.issues.get({ owner: OWNER, repo: REPO, issue_number: ISSUE_NUMBER });
+    const labels = issue.labels.map((l) => (typeof l === 'string' ? l : l.name || '')).filter(Boolean);
+
+    // Score current applicant
+    console.log(`📊 Scoring @${trigger.user}...`);
+    const profile = await fetchProfile(trigger.user, trigger.body);
+    const scored = scoreApplicant(profile, labels);
+    console.log(`  Score: ${scored.score}/100 (Tier ${scored.tier})\n`);
+
+    // Find all applicants
+    const { data: allComments } = await octokit.issues.listComments({ owner: OWNER, repo: REPO, issue_number: ISSUE_NUMBER, per_page: 100 });
+    const BOT_MARKER = '## 🤖 Contributor Agent';
+    const apps = allComments.filter((c) => c.user?.login !== 'github-actions[bot]' && !c.body?.includes(BOT_MARKER) && c.body && isApplicationComment(c.body));
+
+    const byUser = new Map<string, typeof apps[0]>();
+    apps.forEach((c) => { if (c.user?.login) byUser.set(c.user.login, c); });
+    const unique = Array.from(byUser.values());
+    console.log(`  ${unique.length} unique applicant(s)\n`);
+
+    // Score all
+    const allScored: ScoredApplicant[] = [];
+    for (const c of unique) {
+        if (c.user?.login === trigger.user) { allScored.push(scored); continue; }
+        console.log(`  📊 Scoring @${c.user?.login}...`);
+        const p = await fetchProfile(c.user!.login, c.body || '');
+        allScored.push(scoreApplicant(p, labels));
+    }
+
+    // Post individual review
+    const review = buildReviewComment(scored, unique.length);
+    const existingReview = allComments.find((c) => c.body?.includes(BOT_MARKER) && c.body?.includes(`@${trigger.user}`));
+    if (existingReview) {
+        await octokit.issues.updateComment({ owner: OWNER, repo: REPO, comment_id: existingReview.id, body: review });
+    } else {
+        await octokit.issues.createComment({ owner: OWNER, repo: REPO, issue_number: ISSUE_NUMBER, body: review });
+    }
+    console.log(`✅ Review posted for @${trigger.user}`);
+
+    // Post comparison if multiple
+    if (allScored.length >= 2) {
+        const comparison = buildComparisonComment(allScored);
+        const COMP_MARKER = '## 🤖 Contributor Agent — Applicant Comparison';
+        const existingComp = allComments.find((c) => c.body?.includes(COMP_MARKER));
+        if (existingComp) {
+            await octokit.issues.updateComment({ owner: OWNER, repo: REPO, comment_id: existingComp.id, body: comparison });
+        } else {
+            await octokit.issues.createComment({ owner: OWNER, repo: REPO, issue_number: ISSUE_NUMBER, body: comparison });
+        }
+        console.log(`✅ Comparison posted (${allScored.length} candidates)\n`);
+    }
+}
+
+main().catch((e) => { console.error('Fatal:', e); process.exit(1); });