Package dev.dokimos.server.controller.v1

Class DiffController

java.lang.Object

dev.dokimos.server.controller.v1.DiffController

@RestController
@RequestMapping("/api/v1/experiments")
public class DiffController
extends Object

Exposes the per-case run-diff view: the same comparison the CI gate runs, presented as a full, paginated table of every case with per-evaluator deltas. This is a read-only GET and is therefore allowed by the auth filter without an API key.

Constructor Summary

Constructors

Constructor	Description
DiffController(DiffService diffService)

Method Summary

Modifier and Type	Method	Description
DiffView	diff(UUID experimentId, UUID candidateRunId, UUID baselineRunId, String status, org.springframework.data.domain.Pageable pageable)	Returns the per-case diff between a candidate run and an explicit baseline run.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DiffController

public DiffController(DiffService diffService)

Method Details

diff

@GetMapping("/{experimentId}/runs/{candidateRunId}/diff")
public DiffView diff(@PathVariable
 UUID experimentId,
 @PathVariable
 UUID candidateRunId,
 @RequestParam
 UUID baselineRunId,
 @RequestParam(required=false,defaultValue="ALL")
 String status,
 org.springframework.data.domain.Pageable pageable)

Returns the per-case diff between a candidate run and an explicit baseline run.

Parameters:

experimentId - the experiment both runs belong to

candidateRunId - the candidate run (the "new" side)

baselineRunId - the baseline run (the "old" side); required

status - optional case filter: ALL (default), REGRESSED, IMPROVED, or CHANGED

pageable - pagination over the filtered, sorted case list

Returns:

HTTP 200 with the summary and the requested page of cases. 400 when baselineRunId is missing or status is not a recognized value; 404 when the experiment or a run is missing or a run does not belong to the experiment; 409 when either run is not terminal