Add MCP gamification tool with progress notifications

[vitorhugo-java]

Summary

Introduces a new MCP (Model Context Protocol) tool for applying gamification events with real-time progress notifications. This enables AI clients to trigger gamification events and receive incremental feedback during processing.

Key Changes

• New MCP Tool (McpGamificationTools): Exposes Apply-Gamification-Event tool that accepts event type, optional application ID, and timestamp. Translates MCP context into progress callbacks for the service layer.

• Progress-aware Service Method: Added applyEventWithProgress() to GamificationService that fires callbacks at four key milestones (validation, XP award, achievement check, summary build), enabling real-time progress reporting to MCP clients.

• New DTOs and Interfaces:

  • GamificationEventSummary: Aggregated response containing XP gained, level changes, streak days, newly unlocked achievements, and full profile snapshot
  • GamificationProgressCallback: Functional interface for milestone notifications

• Comprehensive Test Suite: 180-line test class covering:

  • Response payload correctness and field propagation
  • Progress notification emission via MCP context
  • Graceful handling of null context and progress exceptions
  • Request mapping with optional parameters

Implementation Details

• Progress notifications are best-effort: exceptions during progress reporting do not fail the tool
• Null context is handled gracefully (no-op callback)
• Newly unlocked achievements are computed by comparing user achievements before and after event processing
• Tool parameters support ISO-8601 timestamps with sensible defaults (current time if omitted)
• All progress callbacks are wrapped in try-catch to prevent protocol errors from affecting gamification logic

https://claude.ai/code/session_01AdifXeCrjZaCemxqXh3SpY

[github-actions]

Qodana for JVM

2 new problems were found

Inspection name	Severity	Problems
Nullability and data flow problems	🔶 Warning	1
Mismatched query and update of 'StringBuilder'	🔶 Warning	1

View the detailed Qodana report

To be able to view the detailed Qodana report, you can either:

• Register at Qodana Cloud and configure the action
• Use GitHub Code Scanning with Qodana
• Host Qodana report at GitHub Pages
• Inspect and use qodana.sarif.json (see the Qodana SARIF format for details)

To get *.log files or any other Qodana artifacts, run the action with upload-result option set to true,
so that the action will upload the files as the job artifacts:

      - name: 'Qodana Scan'
        uses: JetBrains/qodana-action@v2025.3.2
        with:
          upload-result: true

Contact Qodana team

Contact us at qodana-support@jetbrains.com

• Or via our issue tracker: https://jb.gg/qodana-issue
• Or share your feedback: https://jb.gg/qodana-discussions