[graduta]

I have a JIRA ticket

• branch and/or PR name(s) include(s) JIRA ID
• issue has "Fix version" assigned
• issue "Status" is set to "In review"
• PR labels are selected

Part of a stack of PRs documenting the HTTP API (O2B-1623). This PR is stacked on the previous one of the stack (its base is the branch of that PR): GitHub retargets it to main once the PRs below are merged.

Notable changes for users:

• The four GET /api/dpl-process/* endpoints (detectors, processes, hosts, executions) are now documented at /api-docs.
• The ids of these endpoints (run number, detector id, process id, host id) are validated as positive integers: 0, negative numbers and decimals are rejected with a 400 instead of ending as a 404.
• The detectors, processes (and their type), hosts and executions no longer contain createdAt and updatedAt (nothing used them; breaking for any external client reading them).

Notable changes for developers:

• Checked the chain of the endpoints: all 38 files of the chain have their license header, no use case is involved and the router references existing handlers. The frontend (run details page) only reads names, ids, the process type label, the host name and the arguments.
• The four read methods of DplProcessService queried the repositories directly while the creation of an execution already relies on small functions: they now use getDplDetectorIdsWithExecutedProcessesInRun, getAllDplDetectors, getDplProcessIdsExecutedInRunByDetector, getAllDplProcesses, getHostIdsWithExecutedDplProcess, getAllHosts and getAllDplProcessExecutions, each with a test. The two steps of the queries (ids first, then sorted entities) are kept. Checked against the previous service with the SQL layer stubbed: same queries (up to redundant parentheses) and same results.
• The adapters of the DPL detectors, processes, process types, process executions and hosts (only used by these endpoints and by the gRPC creation of an execution, whose response is only the id) stop returning createdAt / updatedAt, and their typedefs are updated. The always empty relations (processesExecutions, and detector, host, process, run set to null) are left as they are: the tests check them.
• The controller disabled the JSDoc rules for the whole file: the handlers are documented. The DplProcessExecution typedef declared strings for processId and hostId (integers) and for args (nullable).

Changes made to the database:

• None

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 43.11%. Comparing base (cdcaebe) to head (defc87e).

Additional details and impacted files

@@                               Coverage Diff                               @@
##           feature/O2B-1623/docs-attachments-endpoints    #2282      +/-   ##
===============================================================================
+ Coverage                                        42.53%   43.11%   +0.57%     
===============================================================================
  Files                                             1064     1071       +7     
  Lines                                            17453    17496      +43     
  Branches                                          3178     3176       -2     
===============================================================================
+ Hits                                              7424     7543     +119     
+ Misses                                           10029     9953      -76     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.