refactor: Expand and refactor next-issue-recommendation bot

[parvninama]

Changes:

• Introduced structured difficulty system

  • Added LEVEL_ORDER, LEVEL_LABEL_ALIASES, and LEVEL_CONFIG to standardize difficulty handling
  • Supports multiple label variants (e.g., skill: beginner) for better compatibility

• Dynamic difficulty progression

  • Determines the completed issue level based on labels
  • Recommends issues from:
    • the next level (if eligible)
    • the same level
    • the previous level (fallback)
  • Uses contribution history (getUserLevelProgress) to gate progression

• Expanded issue discovery across repositories

  • Added getSupportedRepos to dynamically fetch non-archived, non-fork repos
  • Recommendations are no longer limited to the current repository

• Improved recommendation strategy

  • Introduced gatherCandidateIssues with a sequential fallback approach
  • Stops at the first non-empty result set
  • Prioritization ensures more relevant recommendations

• Deduplication and filtering improvements

  • Ensures:
    • no duplicate recommendations (html_url check)
    • already referenced issues are excluded

• More flexible search queries

  • Updated searchIssues to support:
    • multiple repositories
    • multiple label aliases using OR-based queries

• Improved fallback behavior

  • Clearly distinguishes fallback scenarios (previous-level recommendations only)
  • Ensures consistent recommendation labeling based on detected issue level

• Logging improvements

  • Reduced noise by switching some logs to core.debug

Testing:

• In progress

Linked Issue :

• Fixes [Advanced]: Expand and Refactor .github/scripts/bot-next-issue-recommendation.js #1891

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

@@           Coverage Diff           @@
##             main    #1997   +/-   ##
=======================================
  Coverage   93.68%   93.68%           
=======================================
  Files         144      144           
  Lines        9350     9350           
=======================================
  Hits         8760     8760           
  Misses        590      590           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

Hello, this is the OfficeHourBot.

This is a reminder that the Hiero Python SDK Office Hours are scheduled in approximately 4 hours (14:00 UTC).

This session provides an opportunity to ask questions regarding this Pull Request.

Details:

• Time: 14:00 UTC
• Join Link: Zoom Meeting

Disclaimer: This is an automated reminder. Please verify the schedule here for any changes.

From,
The Python SDK Team