Skip to content

Commit 6206fba

Browse files
konardclaude
konard
and
claude
committed
Implement HeadHunter bot for LinksPlatform team recruitment
- Add HeadHunterTrigger: Detects recruitment requests and asks the key question - Add HeadHunterResponseTrigger: Processes yes/no responses, focuses on positive answers - Integrate both triggers into Platform.Bot Program.cs - Add comprehensive documentation in HeadHunterBot.md - Include example test file for validation - Bot asks: "Would you like to become a part of LinksPlatform team?" - Automatically ignores "no" responses to save time as specified - Provides next steps for interested candidates Fixes #212 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
1 parent 5b4f590 commit 6206fba

File tree

5 files changed

+380
-1
lines changed

5 files changed

+380
-1
lines changed

‎csharp/Platform.Bot/HeadHunterBot.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# HeadHunter Bot
2+
3+
## Overview
4+
5+
The HeadHunter Bot is designed to help recruit programmers to join the LinksPlatform team by asking a simple question: **"Would you like to become a part of LinksPlatform team?"**
6+
7+
As specified in the requirements, the bot focuses only on users who answer "yes" and ignores those who answer "no" to save time.
8+
9+
## Features
10+
11+
### 1. HeadHunterTrigger
12+
- **Trigger Condition**: Issues with titles containing "headhunter", "recruit", or "join team"
13+
- **Action**: Posts a recruitment question with clear yes/no options
14+
- **Question**: "Would you like to become a part of LinksPlatform team?"
15+
16+
### 2. HeadHunterResponseTrigger
17+
- **Trigger Condition**: Issues that have received the HeadHunter question and have user responses
18+
- **Action**:
19+
- **For "Yes" responses**: Provides next steps for joining the team
20+
- **For "No" responses**: Thanks the user and closes the issue
21+
22+
## Usage
23+
24+
### Triggering the HeadHunter Bot
25+
26+
Create a GitHub issue with a title containing:
27+
- "headhunter"
28+
- "recruit"
29+
- "join team"
30+
31+
Example issue titles:
32+
- "HeadHunter Request"
33+
- "Recruit new developers"
34+
- "Looking for team members to join"
35+
36+
### Bot Response Flow
37+
38+
1. **Initial Question**: Bot posts the recruitment question with clear options
39+
2. **User Response**: User responds with "Yes" ✅ or "No" ❌
40+
3. **Bot Action**:
41+
- **Yes Response**: Provides detailed next steps for joining
42+
- **No Response**: Politely closes the issue
43+
44+
## Implementation Details
45+
46+
### Files Created
47+
- `HeadHunterTrigger.cs` - Main trigger for posting recruitment questions
48+
- `HeadHunterResponseTrigger.cs` - Processes user responses
49+
- Integration in `Program.cs` - Registers the triggers with the bot system
50+
51+
### Dependencies
52+
- Uses existing `GitHubStorage` class for GitHub API interactions
53+
- Implements `ITrigger<Issue>` interface following the established pattern
54+
- Integrates with existing `IssueTracker` system
55+
56+
## Benefits
57+
58+
1. **Time Efficient**: Automatically ignores "no" responses as specified
59+
2. **Focused Recruitment**: Only processes interested candidates
60+
3. **Consistent Process**: Standardized approach to team recruitment
61+
4. **GitHub Integration**: Works seamlessly within existing GitHub workflows
62+
63+
## Example Interaction
64+
65+
```
66+
User creates issue: "HeadHunter - Looking for C# developers"
67+
↓
68+
Bot responds: "Would you like to become a part of LinksPlatform team?"
69+
↓
70+
User responds: "Yes ✅"
71+
↓
72+
Bot provides next steps with contact information and requirements
73+
```
74+
75+
This implementation fulfills the requirement to create a bot that asks programmers about joining the LinksPlatform team while focusing only on positive responses to save time.

‎csharp/Platform.Bot/Program.cs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@ private static async Task<int> Main(string[] args)
9595
var dbContext = new FileStorage(databaseFilePath?.FullName ?? new TemporaryFile().Filename);
9696
Console.WriteLine($"Bot has been started. {Environment.NewLine}Press CTRL+C to close");
9797
var githubStorage = new GitHubStorage(githubUserName, githubApiToken, githubApplicationName);
98-
var issueTracker = new IssueTracker(githubStorage, new HelloWorldTrigger(githubStorage, dbContext, fileSetName), new OrganizationLastMonthActivityTrigger(githubStorage), new LastCommitActivityTrigger(githubStorage), new AdminAuthorIssueTriggerDecorator(new ProtectDefaultBranchTrigger(githubStorage), githubStorage), new AdminAuthorIssueTriggerDecorator(new ChangeOrganizationRepositoriesDefaultBranchTrigger(githubStorage, dbContext), githubStorage), new AdminAuthorIssueTriggerDecorator(new ChangeOrganizationPullRequestsBaseBranchTrigger(githubStorage, dbContext), githubStorage));
98+
var issueTracker = new IssueTracker(githubStorage, new HelloWorldTrigger(githubStorage, dbContext, fileSetName), new HeadHunterTrigger(githubStorage), new HeadHunterResponseTrigger(githubStorage), new OrganizationLastMonthActivityTrigger(githubStorage), new LastCommitActivityTrigger(githubStorage), new AdminAuthorIssueTriggerDecorator(new ProtectDefaultBranchTrigger(githubStorage), githubStorage), new AdminAuthorIssueTriggerDecorator(new ChangeOrganizationRepositoriesDefaultBranchTrigger(githubStorage, dbContext), githubStorage), new AdminAuthorIssueTriggerDecorator(new ChangeOrganizationPullRequestsBaseBranchTrigger(githubStorage, dbContext), githubStorage));
9999
var pullRequenstTracker = new PullRequestTracker(githubStorage, new MergeDependabotBumpsTrigger(githubStorage));
100100
var timestampTracker = new DateTimeTracker(githubStorage, new CreateAndSaveOrganizationRepositoriesMigrationTrigger(githubStorage, dbContext, Path.Combine(Directory.GetCurrentDirectory(), "/github-migrations")));
101101
var cancellation = new CancellationTokenSource();

‎csharp/Platform.Bot/Triggers/HeadHunterResponseTrigger.cs‎

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
using System.Linq;
2+
using System.Threading.Tasks;
3+
using Interfaces;
4+
using Octokit;
5+
using Storage.Remote.GitHub;
6+
7+
namespace Platform.Bot.Triggers
8+
{
9+
using TContext = Issue;
10+
/// <summary>
11+
/// <para>
12+
/// Represents the HeadHunter response trigger that processes answers to recruitment questions.
13+
/// </para>
14+
/// <para></para>
15+
/// </summary>
16+
/// <seealso cref="ITrigger{TContext}"/>
17+
internal class HeadHunterResponseTrigger : ITrigger<TContext>
18+
{
19+
private readonly GitHubStorage _storage;
20+
private const string HeadHunterQuestion = "Would you like to become a part of LinksPlatform team?";
21+
22+
/// <summary>
23+
/// <para>
24+
/// Initializes a new <see cref="HeadHunterResponseTrigger"/> instance.
25+
/// </para>
26+
/// <para></para>
27+
/// </summary>
28+
/// <param name="storage">
29+
/// <para>A GitHub storage.</para>
30+
/// <para></para>
31+
/// </param>
32+
public HeadHunterResponseTrigger(GitHubStorage storage)
33+
{
34+
this._storage = storage;
35+
}
36+
37+
/// <summary>
38+
/// <para>
39+
/// Determines whether this instance condition should process a HeadHunter response.
40+
/// </para>
41+
/// <para></para>
42+
/// </summary>
43+
/// <param name="context">
44+
/// <para>The issue context.</para>
45+
/// <para></para>
46+
/// </param>
47+
/// <returns>
48+
/// <para>True if this is a response to a HeadHunter question, false otherwise</para>
49+
/// <para></para>
50+
/// </returns>
51+
public async Task<bool> Condition(TContext context)
52+
{
53+
// Check if any comments contain our HeadHunter question
54+
var comments = await _storage.Client.Issue.Comment.GetAllForIssue(context.Repository.Id, context.Number);
55+
var hasHeadHunterQuestion = comments.Any(c => c.Body.Contains(HeadHunterQuestion));
56+
57+
if (!hasHeadHunterQuestion)
58+
return false;
59+
60+
// Check if there are responses from users (not bot)
61+
var lastComment = comments.LastOrDefault();
62+
if (lastComment == null || lastComment.User.Type == AccountType.Bot)
63+
return false;
64+
65+
var body = lastComment.Body.ToLower();
66+
return body.Contains("yes") || body.Contains("no") || body.Contains("✅") || body.Contains("❌");
67+
}
68+
69+
/// <summary>
70+
/// <para>
71+
/// Actions the HeadHunter response by processing yes/no answers.
72+
/// </para>
73+
/// <para></para>
74+
/// </summary>
75+
/// <param name="context">
76+
/// <para>The issue context.</para>
77+
/// <para></para>
78+
/// </param>
79+
public async Task Action(TContext context)
80+
{
81+
var comments = await _storage.Client.Issue.Comment.GetAllForIssue(context.Repository.Id, context.Number);
82+
var lastComment = comments.LastOrDefault();
83+
84+
if (lastComment == null) return;
85+
86+
var body = lastComment.Body.ToLower();
87+
var isPositiveResponse = body.Contains("yes") || body.Contains("✅");
88+
89+
if (isPositiveResponse)
90+
{
91+
// Focus on positive responses - provide next steps
92+
var followUpComment = $"Great to hear you're interested, @{lastComment.User.Login}! 🎉\n\n" +
93+
$"Welcome to the LinksPlatform community! Here are your next steps:\n\n" +
94+
$"1. 📧 **Contact Information**: Please provide your contact details (email/Discord/Telegram)\n" +
95+
$"2. 💻 **Skills**: Tell us about your programming experience and preferred languages\n" +
96+
$"3. 🎯 **Interests**: Which areas of platform development interest you most?\n" +
97+
$"4. 🔗 **Portfolio**: Share your GitHub profile or any relevant projects\n\n" +
98+
$"A team member will reach out to you soon with more information about contributing " +
99+
$"to our projects and potentially joining the organization.\n\n" +
100+
$"*Thank you for your interest in LinksPlatform! 🚀*";
101+
102+
await _storage.CreateIssueComment(context.Repository.Id, context.Number, followUpComment);
103+
}
104+
else if (body.Contains("no") || body.Contains("❌"))
105+
{
106+
// Close the issue for negative responses as per requirement
107+
var closingComment = $"Thank you for your response, @{lastComment.User.Login}. " +
108+
$"We understand and respect your decision. " +
109+
$"Feel free to reach out in the future if you change your mind! 👋";
110+
111+
await _storage.CreateIssueComment(context.Repository.Id, context.Number, closingComment);
112+
_storage.CloseIssue(context);
113+
}
114+
}
115+
}
116+
}

‎csharp/Platform.Bot/Triggers/HeadHunterTrigger.cs‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
using System.Threading.Tasks;
2+
using Interfaces;
3+
using Octokit;
4+
using Storage.Remote.GitHub;
5+
6+
namespace Platform.Bot.Triggers
7+
{
8+
using TContext = Issue;
9+
/// <summary>
10+
/// <para>
11+
/// Represents the HeadHunter bot trigger that asks programmers to join LinksPlatform team.
12+
/// </para>
13+
/// <para></para>
14+
/// </summary>
15+
/// <seealso cref="ITrigger{TContext}"/>
16+
internal class HeadHunterTrigger : ITrigger<TContext>
17+
{
18+
private readonly GitHubStorage _storage;
19+
private const string HeadHunterQuestion = "Would you like to become a part of LinksPlatform team?";
20+
21+
/// <summary>
22+
/// <para>
23+
/// Initializes a new <see cref="HeadHunterTrigger"/> instance.
24+
/// </para>
25+
/// <para></para>
26+
/// </summary>
27+
/// <param name="storage">
28+
/// <para>A GitHub storage.</para>
29+
/// <para></para>
30+
/// </param>
31+
public HeadHunterTrigger(GitHubStorage storage)
32+
{
33+
this._storage = storage;
34+
}
35+
36+
/// <summary>
37+
/// <para>
38+
/// Determines whether this instance condition should trigger the HeadHunter bot.
39+
/// </para>
40+
/// <para></para>
41+
/// </summary>
42+
/// <param name="context">
43+
/// <para>The issue context.</para>
44+
/// <para></para>
45+
/// </param>
46+
/// <returns>
47+
/// <para>True if this is a HeadHunter request, false otherwise</para>
48+
/// <para></para>
49+
/// </returns>
50+
public async Task<bool> Condition(TContext context)
51+
{
52+
var title = context.Title.ToLower();
53+
return title.Contains("headhunter") || title.Contains("recruit") || title.Contains("join team");
54+
}
55+
56+
/// <summary>
57+
/// <para>
58+
/// Actions the HeadHunter bot by posting the recruitment question.
59+
/// </para>
60+
/// <para></para>
61+
/// </summary>
62+
/// <param name="context">
63+
/// <para>The issue context.</para>
64+
/// <para></para>
65+
/// </param>
66+
public async Task Action(TContext context)
67+
{
68+
var comment = $"Hello @{context.User.Login}! 👋\n\n" +
69+
$"{HeadHunterQuestion}\n\n" +
70+
$"If you're interested in contributing to open source projects focused on data structures, " +
71+
$"algorithms, and platform development, we'd love to have you on board!\n\n" +
72+
$"Please respond with:\n" +
73+
$"- ✅ **Yes** - if you're interested in joining\n" +
74+
$"- ❌ **No** - if you're not interested (we'll mark this as resolved)\n\n" +
75+
$"*Note: We focus our attention only on positive responses to save everyone's time.*";
76+
77+
await _storage.CreateIssueComment(context.Repository.Id, context.Number, comment);
78+
}
79+
}
80+
}

‎examples/HeadHunterBotTest.cs‎

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
using System;
2+
using System.Threading.Tasks;
3+
using Octokit;
4+
using Platform.Bot.Triggers;
5+
using Storage.Remote.GitHub;
6+
7+
namespace Examples
8+
{
9+
/// <summary>
10+
/// Simple test class to verify HeadHunter bot functionality
11+
/// This is a basic test to ensure the triggers work as expected
12+
/// </summary>
13+
public class HeadHunterBotTest
14+
{
15+
public static async Task TestHeadHunterTriggerConditions()
16+
{
17+
Console.WriteLine("Testing HeadHunter Bot Conditions...");
18+
19+
// Create mock GitHubStorage (for testing we use null - in real usage this would be properly initialized)
20+
var storage = new GitHubStorage("test", "test", "test");
21+
var headHunterTrigger = new HeadHunterTrigger(storage);
22+
var responseTriggger = new HeadHunterResponseTrigger(storage);
23+
24+
// Test cases for HeadHunterTrigger.Condition
25+
var testCases = new[]
26+
{
27+
new { Title = "HeadHunter Request", Expected = true },
28+
new { Title = "Looking to recruit developers", Expected = true },
29+
new { Title = "Want to join team", Expected = true },
30+
new { Title = "Regular issue", Expected = false },
31+
new { Title = "Bug fix needed", Expected = false },
32+
new { Title = "HEADHUNTER - urgent", Expected = true }, // Case insensitive
33+
};
34+
35+
Console.WriteLine("HeadHunterTrigger Condition Tests:");
36+
foreach (var testCase in testCases)
37+
{
38+
try
39+
{
40+
// Create mock issue for testing
41+
var mockIssue = CreateMockIssue(testCase.Title, "testuser");
42+
43+
// This would normally require proper mocking, but we can test the logic
44+
var titleLower = testCase.Title.ToLower();
45+
var actualResult = titleLower.Contains("headhunter") ||
46+
titleLower.Contains("recruit") ||
47+
titleLower.Contains("join team");
48+
49+
var status = actualResult == testCase.Expected ? "✅ PASS" : "❌ FAIL";
50+
Console.WriteLine($" {status}: '{testCase.Title}' -> Expected: {testCase.Expected}, Got: {actualResult}");
51+
}
52+
catch (Exception ex)
53+
{
54+
Console.WriteLine($" ❌ ERROR: {testCase.Title} - {ex.Message}");
55+
}
56+
}
57+
58+
Console.WriteLine("\nTest Summary:");
59+
Console.WriteLine("- HeadHunterTrigger: Responds to issues with 'headhunter', 'recruit', or 'join team' in title");
60+
Console.WriteLine("- HeadHunterResponseTrigger: Processes user responses (yes/no) to recruitment questions");
61+
Console.WriteLine("- Integration: Both triggers are registered in Program.cs IssueTracker");
62+
Console.WriteLine("\nHeadHunter Bot is ready to help recruit developers! 🚀");
63+
}
64+
65+
private static Issue CreateMockIssue(string title, string userLogin)
66+
{
67+
// This is a simplified mock - in real testing we'd use proper mocking frameworks
68+
// For now, this demonstrates the test structure
69+
return new Issue(
70+
url: "https://test.com",
71+
htmlUrl: "https://test.com",
72+
commentsUrl: "https://test.com",
73+
eventsUrl: "https://test.com",
74+
number: 1,
75+
state: ItemState.Open,
76+
title: title,
77+
body: "Test issue body",
78+
user: new User(), // Simplified - would need proper User mock
79+
labels: new System.Collections.ObjectModel.ReadOnlyCollection<Label>(new Label[0]),
80+
assignee: null,
81+
assignees: new System.Collections.ObjectModel.ReadOnlyCollection<User>(new User[0]),
82+
milestone: null,
83+
comments: 0,
84+
pullRequest: null,
85+
closedAt: null,
86+
createdAt: DateTimeOffset.Now,
87+
updatedAt: DateTimeOffset.Now,
88+
id: 1,
89+
nodeId: "test",
90+
locked: false,
91+
repository: null,
92+
reactions: null,
93+
activeLockReason: null,
94+
closedBy: null,
95+
stateReason: null
96+
);
97+
}
98+
}
99+
}
100+
101+
// Instructions to run this test:
102+
// 1. This is a conceptual test showing the HeadHunter bot logic
103+
// 2. In a real environment, you would:
104+
// - Add proper unit testing framework (xUnit, NUnit, etc.)
105+
// - Use mocking libraries (Moq, NSubstitute) for GitHubStorage
106+
// - Create proper integration tests with test GitHub repos
107+
// 3. To verify the bot works, create GitHub issues with titles containing:
108+
// "headhunter", "recruit", or "join team"

0 commit comments

Comments
 (0)