Merge branch 'main' into fix-gfi-notification

Signed-off-by: Abhijeet <abhijeetsaharan2236@gmail.com>

Author: Abhijeet2409

.github/scripts/bot-next-issue-recommendation.js

@@ -0,0 +1,188 @@
+module.exports = async ({ github, context, core }) => {
+  const { payload } = context;
+  
+  // Get PR information from automatic pull_request_target trigger
+  let prNumber = payload.pull_request?.number;
+  let prBody = payload.pull_request?.body || '';
+  
+  // Manual workflow_dispatch is no longer supported - inputs were removed
+  // Only automatic triggers from merged PRs will work
+  const repoOwner = context.repo.owner;
+  const repoName = context.repo.repo;
+  
+  if (!prNumber) {
+    core.info('No PR number found, skipping');
+    return;
+  }
+  
+  core.info(`Processing PR #${prNumber}`);
+  
+  // Parse PR body to find linked issues
+  const MAX_PR_BODY_LENGTH = 50000; // Reasonable limit for PR body
+  if (prBody.length > MAX_PR_BODY_LENGTH) {
+    core.warning(`PR body exceeds ${MAX_PR_BODY_LENGTH} characters, truncating for parsing`);
+    prBody = prBody.substring(0, MAX_PR_BODY_LENGTH);
+  }
+  const issueRegex = /(fixes|closes|resolves|fix|close|resolve)\s+(?:[\w-]+\/[\w-]+)?#(\d+)/gi;
+  const matches = [...prBody.matchAll(issueRegex)];
+  
+  if (matches.length === 0) {
+    core.info('No linked issues found in PR body');
+    return;
+  }
+  
+  // Get the first linked issue number
+  const issueNumber = parseInt(matches[0][2]);
+  core.info(`Found linked issue #${issueNumber}`);
+  
+  try {
+    // Fetch issue details
+    const { data: issue } = await github.rest.issues.get({
+      owner: repoOwner,
+      repo: repoName,
+      issue_number: issueNumber,
+    });
+    
+    // Normalize and check issue labels (case-insensitive)
+    const labelNames = issue.labels.map(label => label.name.toLowerCase());
+    const labelSet = new Set(labelNames);
+    core.info(`Issue labels: ${labelNames.join(', ')}`);
+    
+    // Determine issue difficulty level
+    const difficultyLevels = {
+      beginner: labelSet.has('beginner'),
+      goodFirstIssue: labelSet.has('good first issue'),
+      intermediate: labelSet.has('intermediate'),
+      advanced: labelSet.has('advanced'),
+    };
+    
+    // Skip if intermediate or advanced
+    if (difficultyLevels.intermediate || difficultyLevels.advanced) {
+      core.info('Issue is intermediate or advanced level, skipping recommendation');
+      return;
+    }
+    
+    // Only proceed for Good First Issue or beginner issues
+    if (!difficultyLevels.goodFirstIssue && !difficultyLevels.beginner) {
+      core.info('Issue is not a Good First Issue or beginner issue, skipping');
+      return;
+    }
+    
+    let recommendedIssues = [];
+    
+    if (difficultyLevels.goodFirstIssue) {
+      // Recommend beginner issues first, then Good First Issues
+      recommendedIssues = await searchIssues(github, core, repoOwner, repoName, 'beginner');
+      if (recommendedIssues.length === 0) {
+        recommendedIssues = await searchIssues(github, core, repoOwner, repoName, 'good first issue');
+      }
+    } else if (difficultyLevels.beginner) {
+      // Recommend beginner or Good First Issues
+      recommendedIssues = await searchIssues(github, core, repoOwner, repoName, 'beginner');
+      if (recommendedIssues.length === 0) {
+        recommendedIssues = await searchIssues(github, core, repoOwner, repoName, 'good first issue');
+      }
+    }
+    
+    // Generate and post comment
+    await generateAndPostComment(github, context, core, prNumber, recommendedIssues, difficultyLevels.goodFirstIssue);
+    
+  } catch (error) {
+    core.setFailed(`Error processing issue #${issueNumber}: ${error.message}`);
+  }
+};
+
+async function searchIssues(github, core, owner, repo, label) {
+  try {
+    const query = `repo:${owner}/${repo} is:issue is:open label:"${label}" no:assignee`;
+    core.info(`Searching for issues with query: ${query}`);
+    
+    const { data: searchResult } = await github.rest.search.issuesAndPullRequests({
+      q: query,
+      per_page: 5,
+    });
+    
+    core.info(`Found ${searchResult.items.length} issues with label "${label}"`);
+    return searchResult.items;
+  } catch (error) {
+    core.warning(`Error searching for issues with label "${label}": ${error.message}`);
+    return [];
+  }
+}
+
+async function generateAndPostComment(github, context, core, prNumber, recommendedIssues, wasGoodFirstIssue) {
+  const marker = '<!-- next-issue-bot-marker -->';
+  
+  // Build comment content
+  let comment = `${marker}\n\n🎉 **Congratulations on completing a beginner/Good First Issue!**\n\n`;
+  comment += `Thank you for your contribution to the Hiero Python SDK! We're excited to have you as part of our community.\n\n`;
+  
+  if (recommendedIssues.length > 0) {
+    comment += `Here are some ${wasGoodFirstIssue ? 'beginner-level' : 'similar'} issues you might be interested in working on next:\n\n`;
+    
+    // Sanitize title: escape markdown link syntax and special characters
+    const sanitizeTitle = (title) => title
+      .replace(/\[/g, '\\[')
+      .replace(/\]/g, '\\]')
+      .replace(/\(/g, '\\(')
+      .replace(/\)/g, '\\)');
+
+    recommendedIssues.slice(0, 5).forEach((issue, index) => {
+      comment += `${index + 1}. [${sanitizeTitle(issue.title)}](${issue.html_url})\n`;
+      if (issue.body && issue.body.length > 0) {
+        // Sanitize: strip HTML, normalize whitespace, escape markdown links
+        const sanitized = issue.body
+          .replace(/<[^>]*>/g, '') // Remove HTML tags
+          .replace(/\[([^\]]*)\]\([^)]*\)/g, '$1') // Remove markdown links, keep text
+          .replace(/\s+/g, ' ') // Normalize whitespace
+          .trim();
+        const description = sanitized.substring(0, 150);
+        comment += `   ${description}${sanitized.length > 150 ? '...' : ''}\n\n`;
+      } else {
+        comment += `   *No description available*\n\n`;
+      }
+    });
+  } else {
+    comment += `There are currently no open ${wasGoodFirstIssue ? 'beginner' : 'similar'} issues in this repository. \n\n`;
+    comment += `You can check out good first issues across the entire Hiero organization: [Hiero Good First Issues](https://github.com/issues?q=is%3Aopen+is%3Aissue+org%3Ahiero-ledger+archived%3Afalse+label%3A%22good+first+issue%22+)\n\n`;
+  }
+  
+  comment += `🌟 **Stay connected with the project:**\n`;
+  comment += `- ⭐ [Star this repository](https://github.com/${context.repo.owner}/${context.repo.repo}) to show your support\n`;
+  comment += `- 👀 [Watch this repository](https://github.com/${context.repo.owner}/${context.repo.repo}/watchers) to get notified of new issues and releases\n\n`;
+  
+  comment += `We look forward to seeing more contributions from you! If you have any questions, feel free to ask in our [Discord community](https://github.com/hiero-ledger/hiero-sdk-python/blob/main/docs/discord.md).\n\n`;
+  comment += `From the Hiero Python SDK Team 🚀`;
+  
+  // Check for existing comment
+  try {
+    const { data: comments } = await github.rest.issues.listComments({
+      owner: context.repo.owner,
+      repo: context.repo.repo,
+      issue_number: prNumber,
+    });
+    
+    const existingComment = comments.find(comment => comment.body.includes(marker));
+    
+    if (existingComment) {
+      core.info('Comment already exists, skipping');
+      return;
+    }
+  } catch (error) {
+    core.warning(`Error checking existing comments: ${error.message}`);
+  }
+  
+  // Post the comment
+  try {
+    await github.rest.issues.createComment({
+      owner: context.repo.owner,
+      repo: context.repo.repo,
+      issue_number: prNumber,
+      body: comment,
+    });
+    
+    core.info(`Successfully posted comment to PR #${prNumber}`);
+  } catch (error) {
+    core.setFailed(`Error posting comment: ${error.message}`);
+  }
+}