feat: add manual interview count update via API and MCP

Adds PATCH /api/v1/dashboard/interview-count endpoint and
Update-Interview-Count MCP tool so users can correct the cumulative
interview counter when the automatic detection misses transitions.

https://claude.ai/code/session_015kfgrc2oHA881RT3bEYHZ6

Author: claude

src/main/java/com/jobtracker/controller/DashboardController.java

@@ -1,14 +1,20 @@
 package com.jobtracker.controller;
 
 import com.jobtracker.dto.dashboard.DashboardSummaryResponse;
+import com.jobtracker.dto.dashboard.UpdateInterviewCountRequest;
 import com.jobtracker.service.DashboardService;
+import com.jobtracker.service.InterviewMetricsService;
+import com.jobtracker.util.SecurityUtils;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.media.Content;
 import io.swagger.v3.oas.annotations.media.Schema;
 import io.swagger.v3.oas.annotations.responses.ApiResponse;
 import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RestController;
 
@@ -18,9 +24,15 @@
 public class DashboardController {
 
     private final DashboardService dashboardService;
+    private final InterviewMetricsService interviewMetricsService;
+    private final SecurityUtils securityUtils;
 
-    public DashboardController(DashboardService dashboardService) {
+    public DashboardController(DashboardService dashboardService,
+                               InterviewMetricsService interviewMetricsService,
+                               SecurityUtils securityUtils) {
         this.dashboardService = dashboardService;
+        this.interviewMetricsService = interviewMetricsService;
+        this.securityUtils = securityUtils;
     }
 
     @Operation(
@@ -36,4 +48,19 @@ public DashboardController(DashboardService dashboardService) {
     public ResponseEntity<DashboardSummaryResponse> getSummary() {
         return ResponseEntity.ok(dashboardService.getSummary());
     }
+
+    @Operation(
+        summary = "Update interview count",
+        description = "Manually sets the cumulative interview count for the authenticated user",
+        responses = {
+            @ApiResponse(responseCode = "204", description = "Count updated"),
+            @ApiResponse(responseCode = "400", description = "Invalid count value"),
+            @ApiResponse(responseCode = "401", description = "Not authenticated")
+        }
+    )
+    @PatchMapping("/interview-count")
+    public ResponseEntity<Void> updateInterviewCount(@Valid @RequestBody UpdateInterviewCountRequest request) {
+        interviewMetricsService.setInterviewCount(securityUtils.getCurrentUserId(), request.count());
+        return ResponseEntity.noContent().build();
+    }
 }

src/main/java/com/jobtracker/dto/dashboard/UpdateInterviewCountRequest.java

@@ -0,0 +1,7 @@
+package com.jobtracker.dto.dashboard;
+
+import jakarta.validation.constraints.Min;
+
+public record UpdateInterviewCountRequest(
+        @Min(0) long count
+) {}

src/main/java/com/jobtracker/mcp/tools/McpAnalyticsTools.java

@@ -9,6 +9,7 @@
 import com.jobtracker.mapper.ApplicationMapper;
 import com.jobtracker.repository.ApplicationRepository;
 import com.jobtracker.service.ApplicationService;
+import com.jobtracker.service.InterviewMetricsService;
 import com.jobtracker.util.SecurityUtils;
 import org.springaicommunity.mcp.annotation.McpTool;
 import org.springaicommunity.mcp.annotation.McpTool.McpAnnotations;
@@ -33,18 +34,39 @@ public class McpAnalyticsTools {
     private final ApplicationRepository applicationRepository;
     private final ApplicationMapper applicationMapper;
     private final ApplicationService applicationService;
+    private final InterviewMetricsService interviewMetricsService;
     private final SecurityUtils securityUtils;
 
     public McpAnalyticsTools(ApplicationRepository applicationRepository,
                               ApplicationMapper applicationMapper,
                               ApplicationService applicationService,
+                              InterviewMetricsService interviewMetricsService,
                               SecurityUtils securityUtils) {
         this.applicationRepository = applicationRepository;
         this.applicationMapper = applicationMapper;
         this.applicationService = applicationService;
+        this.interviewMetricsService = interviewMetricsService;
         this.securityUtils = securityUtils;
     }
 
+    @McpTool(
+            name = "Update-Interview-Count",
+            title = "Update Interview Count",
+            description = "Manually sets the cumulative interview count for the current user. Use this when the automatic counter missed interviews or needs correction.",
+            annotations = @McpAnnotations(
+                    title = "Update Interview Count",
+                    readOnlyHint = false,
+                    destructiveHint = false,
+                    idempotentHint = true,
+                    openWorldHint = false))
+    @Transactional
+    public String updateInterviewCount(
+            @McpToolParam(required = true, description = "The new total interview count (must be >= 0)") long count) {
+        UUID userId = securityUtils.getCurrentUserId();
+        interviewMetricsService.setInterviewCount(userId, count);
+        return "Interview count updated to " + count;
+    }
+
     @McpTool(
             name = "Get-Analytics",
             title = "Get Analytics",

src/main/java/com/jobtracker/service/InterviewMetricsService.java

@@ -7,6 +7,7 @@
 import com.jobtracker.entity.enums.ApplicationStatus;
 import com.jobtracker.repository.InterviewEventRepository;
 import com.jobtracker.repository.UserInterviewMetricsRepository;
+import com.jobtracker.repository.UserRepository;
 import org.springframework.stereotype.Service;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -29,11 +30,14 @@ public class InterviewMetricsService {
 
     private final UserInterviewMetricsRepository metricsRepository;
     private final InterviewEventRepository eventRepository;
+    private final UserRepository userRepository;
 
     public InterviewMetricsService(UserInterviewMetricsRepository metricsRepository,
-                                   InterviewEventRepository eventRepository) {
+                                   InterviewEventRepository eventRepository,
+                                   UserRepository userRepository) {
         this.metricsRepository = metricsRepository;
         this.eventRepository = eventRepository;
+        this.userRepository = userRepository;
     }
 
     public boolean isInterviewStatus(String status) {
@@ -77,6 +81,21 @@ public void recordStatusTransition(JobApplication application,
         eventRepository.save(event);
     }
 
+    @Transactional
+    public void setInterviewCount(UUID userId, long count) {
+        if (count < 0) throw new IllegalArgumentException("Interview count cannot be negative");
+        UserInterviewMetrics metrics = metricsRepository.findByUser_Id(userId)
+                .orElseGet(() -> {
+                    User user = userRepository.getReferenceById(userId);
+                    UserInterviewMetrics created = new UserInterviewMetrics();
+                    created.setUser(user);
+                    created.setInterviewCount(0);
+                    return created;
+                });
+        metrics.setInterviewCount(count);
+        metricsRepository.save(metrics);
+    }
+
     @Transactional(readOnly = true)
     public long getInterviewCount(UUID userId) {
         return metricsRepository.findById(userId)