[Workflow]: Create GSSoC'25 Contribution Report Generator with Time Filtering

[Copilot]

This PR implements a comprehensive GitHub Actions workflow to generate detailed contribution reports for GSSoC'25 participants. The workflow addresses the need for automated contribution tracking and recognition within the program.

🚀 Features Implemented

Manual Workflow Trigger

• Workflow Dispatch: Can be triggered manually from GitHub Actions UI
• Flexible Scheduling: On-demand report generation for any time period
• User-Friendly Interface: Simple dropdown selections for configuration

Time Period Filtering

The workflow supports 6 different time filter options:

• 1 day - Recent activity tracking
• 1 week - Weekly progress reports
• 1 month - Monthly contribution summaries (default)
• 90 days - Quarterly analysis
• 6 months - Semester reviews
• 1 year - Annual contribution reports

Multiple Output Formats

• Markdown: Human-readable reports with rich formatting, contributor rankings, and timeline analysis
• JSON: Structured data format for programmatic analysis and integration
• CSV: Spreadsheet-compatible format with separate contributor summary

Comprehensive Report Content

• Contributor Statistics: Rankings by contribution count with profile links and avatars
• Pull Request Timeline: Chronological view of all contributions with merge status
• Label Distribution: Analysis of PR categorization and types
• Summary Metrics: Total PRs, unique contributors, and activity trends
• Rich Metadata: Generation timestamps, filters applied, and workflow information

🛠️ Technical Implementation

GitHub API Integration

• Uses pagination to handle repositories with large numbers of PRs
• Respects rate limits with proper error handling
• Filters PRs by gssoc25 label and specified time range
• Fetches complete contributor profiles and PR metadata

Report Generation

• Dynamic date range calculation based on selected filter
• Advanced JSON processing with jq for data transformation
• Artifact storage with 30-day retention for easy access
• Workflow summary with key metrics display

Documentation

• User Guide: Step-by-step instructions in .github/CONTRIBUTION_REPORT_GUIDE.md
• Integration: Added workflow documentation to existing README files
• Examples: Sample report structures and use cases

📊 Sample Usage

# Workflow can be triggered with:
Time Filter: "1_month"
Output Format: "markdown"

# Generates downloadable report artifact:
gssoc25-contribution-report-1_month-markdown.zip

The generated reports provide valuable insights for:

• Project Maintainers: Track contributor activity and recognize top contributors
• Contributors: Monitor personal progress and team dynamics
• Program Organizers: Analyze participation patterns and export data for further analysis

🔧 Files Added/Modified

• .github/workflows/contribution-report.yml - Main workflow implementation
• .github/CONTRIBUTION_REPORT_GUIDE.md - Comprehensive user documentation
• .github/workflows/README.md - Updated with new workflow information
• README.md - Added reference to contribution reports in GSSoC'25 section

This implementation provides a professional-grade solution for contribution tracking that scales with repository growth and supports various reporting needs throughout the GSSoC'25 program.

Fixes #145.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.