Faults

Requirement: GET /{entity}/faults REQ_INTEROP_012

status: verified tags: Faults is verified by: TEST_test_55_root_endpoint_includes_faults, TEST_test_56_list_faults_response_structure, TEST_test_57_faults_nonexistent_component

The endpoint shall return the list of diagnostic fault entries stored for the addressed entity, possibly including active and stored faults.

Requirement: GET /{entity}/faults/{code} REQ_INTEROP_013

status: verified tags: Faults, SOVD is verified by: TEST_test_131_fault_response_structure, TEST_test_132_fault_status_object_structure, TEST_test_133_fault_environment_data_structure, TEST_test_134_fault_snapshot_freeze_frame_structure, TEST_test_135_fault_snapshot_rosbag_has_bulk_data_uri, TEST_test_136_fault_x_medkit_extensions, TEST_test_58_get_nonexistent_fault

The endpoint shall return detailed information for the addressed diagnostic fault code, including environment data captured at fault confirmation. Response includes: item: Fault details with SOVD-compliant status object (aggregatedStatus, testFailed, confirmedDTC, pendingDTC) environment_data: Extended data records (timestamps) and snapshots array environment_data.snapshots[]: Array of freeze_frame (topic data) and rosbag (bulk-data reference) entries x-medkit: Extension fields (occurrence_count, reporting_sources, severity_label)

Requirement: DELETE /{entity}/faults REQ_INTEROP_014

status: verified tags: Faults is verified by: TEST_test_90_delete_all_faults_for_component, TEST_test_91_delete_all_faults_for_app, TEST_test_92_delete_all_faults_nonexistent_entity

The endpoint shall clear all diagnostic fault entries stored for the addressed entity, if permitted.

Requirement: DELETE /{entity}/faults/{code} REQ_INTEROP_015

status: verified tags: Faults is verified by: TEST_test_95_delete_single_fault

The endpoint shall clear the addressed diagnostic fault code for the entity, if permitted.

Requirement: Fault Snapshot and Rosbag Capture REQ_INTEROP_088

status: verified tags: Faults, BulkData is verified by: TEST_test_16_snapshot_capture_on_fault_confirmation, TEST_test_17_get_snapshots_nonexistent_fault, TEST_test_18_get_snapshots_empty_fault_code, TEST_test_19_snapshot_with_topic_filter, TEST_test_20_snapshot_config_loads_patterns, TEST_test_65_root_endpoint_includes_snapshots

When a fault is confirmed, the system shall automatically capture diagnostic snapshots (freeze-frame topic data) and rosbag recordings as configured. Captured data shall be stored as environment data associated with the fault and accessible via the bulk-data endpoints on the fault’s reporting entity.