feat(faults): add global DELETE /api/v1/faults endpoint

[mfaferek93]

Closes #226

Pull Request

Summary

Add DELETE /api/v1/faults to clear all faults system-wide regardless of entity ownership. Supports optional ?status= query parameter for filtering. Returns 204 No Content on success.

This is a ros2_medkit extension (not SOVD). Mirrors the existing GET /api/v1/faults convenience endpoint.

---

Issue

• closes Add global DELETE /api/v1/faults endpoint (extension) #226

---

Type

• Bug fix
• New feature or tests
• Breaking change
• Documentation only

---

Testing

• 3 integration tests added: basic DELETE 204, ?status=all, invalid status 400
• Manual: curl -X DELETE http://localhost:8080/api/v1/faults returns 204

---

Checklist

• Breaking changes are clearly described (and announced in docs / changelog if needed)
• Tests were added or updated if needed
• Docs were updated if behavior or public API changed

[Copilot]

Pull request overview

Adds a global fault-management REST extension to allow clearing faults system-wide (not scoped to a specific entity), aligning with the existing convenience GET /api/v1/faults endpoint.

Changes:

• Registers DELETE /api/v1/faults and implements a handler that lists faults and clears them (optionally filtered by ?status=).
• Adds integration tests covering success responses for the new DELETE route and invalid status handling.
• Documents the new global DELETE endpoint in the REST API docs.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/ros2_medkit_gateway/src/http/rest_server.cpp	Registers the new global DELETE /faults route.
src/ros2_medkit_gateway/src/http/handlers/fault_handlers.cpp	Implements global clear logic by listing faults and calling clear_fault() per code.
src/ros2_medkit_gateway/include/ros2_medkit_gateway/http/handlers/fault_handlers.hpp	Exposes the new handler method and updates the endpoint list comment.
src/ros2_medkit_gateway/test/test_integration.test.py	Adds integration coverage for the new DELETE endpoint (status code / invalid param).
docs/api/rest.rst	Documents DELETE /api/v1/faults as an extension endpoint.

[bburda]

Solid change - mirrors the existing GET /api/v1/faults nicely, reuses parse_fault_status_param, correctly returns 204. The docs fix (200->204) for the existing single-fault DELETE also aligns with SOVD spec.

3 inline comments below.