Faults

Requirement: GET /{entity}/faults REQ_INTEROP_012

status: verified tags: Faults is verified by: TEST_FaultEventPublishingTest_ListFaultsForEntityEmptyResult, TEST_FaultEventPublishingTest_ListFaultsForEntitySuccess, TEST_FaultEventPublishingTest_ListFaultsForEntityWithEmptyId, TEST_TestFaultsApi_test_faults_nonexistent_component, TEST_TestFaultsApi_test_list_faults_response_structure, TEST_TestFaultsApi_test_root_endpoint_includes_faults, TEST_TestScenarioFaultLifecycle_test_01_wait_for_faults_to_appear

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_FaultHandlersTest_BuildSovdFaultResponseBasicFields, TEST_FaultHandlersTest_BuildSovdFaultResponseExtendedDataRecords, TEST_FaultHandlersTest_BuildSovdFaultResponseMixedSnapshots, TEST_FaultHandlersTest_BuildSovdFaultResponseMultipleSources, TEST_FaultHandlersTest_BuildSovdFaultResponseNestedEntityPath, TEST_FaultHandlersTest_BuildSovdFaultResponsePrimaryValueExtraction, TEST_FaultHandlersTest_BuildSovdFaultResponseSeverityLabels, TEST_FaultHandlersTest_BuildSovdFaultResponseStatusCleared, TEST_FaultHandlersTest_BuildSovdFaultResponseStatusPassive, TEST_FaultHandlersTest_BuildSovdFaultResponseWithFreezeFrame, TEST_FaultHandlersTest_BuildSovdFaultResponseWithInvalidJson, TEST_FaultHandlersTest_BuildSovdFaultResponseWithRosbag, TEST_TestFaultsApi_test_get_nonexistent_fault, TEST_TestScenarioFaultInspection_test_01_fault_response_structure, TEST_TestScenarioFaultInspection_test_02_fault_status_object_structure, TEST_TestScenarioFaultInspection_test_03_fault_environment_data_structure, TEST_TestScenarioFaultInspection_test_04_fault_snapshot_freeze_frame, TEST_TestScenarioFaultInspection_test_05_fault_snapshot_rosbag_has_bulk_data_uri, TEST_TestScenarioFaultInspection_test_06_fault_x_medkit_extensions

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_TestScenarioFaultLifecycle_test_02_delete_all_faults_for_component, TEST_TestScenarioFaultLifecycle_test_03_delete_all_faults_for_app, TEST_TestScenarioFaultLifecycle_test_04_delete_all_faults_nonexistent

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_TestScenarioFaultLifecycle_test_05_delete_single_fault

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

Requirement: Per-Entity Debounce Thresholds REQ_INTEROP_095

status: verified tags: Faults is verified by: TEST_PerEntityStorageTest_BackwardCompatibleWithoutResolver, TEST_PerEntityStorageTest_DifferentEntitiesSameFaultCode, TEST_PerEntityStorageTest_LidarFaultConfirmsImmediately, TEST_PerEntityStorageTest_LidarHealingWithThreshold1, TEST_PerEntityStorageTest_MotorFaultNeedsDebouncing, TEST_PerEntityStorageTest_UnknownEntityUsesGlobalConfig, TEST_ResolverTest_EmptyResolverReturnsGlobal, TEST_ResolverTest_ExactMatch, TEST_ResolverTest_LongestPrefixWins, TEST_ResolverTest_NoMatchReturnsGlobal, TEST_ResolverTest_PartialOverrideMergesWithGlobal, TEST_ResolverTest_PrefixMatch, TEST_ResolverTest_PrefixMatchRequiresPathBoundary, TEST_ResolverTest_SizeReturnsEntryCount, TEST_YamlLoadTest_LoadValidFile, TEST_YamlLoadTest_MalformedYamlReturnsEmpty, TEST_YamlLoadTest_MissingFileReturnsEmpty, TEST_YamlLoadTest_PositiveConfirmationThresholdAutoNegated

The fault manager shall support per-entity debounce threshold configuration using longest-prefix matching on the reporting entity’s source_id. Entity-specific overrides for confirmation_threshold, healing_enabled, and healing_threshold shall take precedence over global defaults. Unspecified fields shall inherit from global configuration. When no entity prefix matches, global defaults shall apply.

Requirement: Fault Snapshot and Rosbag Capture REQ_INTEROP_088

status: verified tags: Faults, BulkData is verified by: TEST_FaultManagerTest_GetRosbagNotFound, TEST_FaultManagerTest_GetRosbagServiceNotAvailable, TEST_FaultManagerTest_GetRosbagSuccess, TEST_FaultManagerTest_GetRosbagUsesConfiguredFaultManagerNamespace, TEST_FaultManagerTest_GetSnapshotsEmptyResponse, TEST_FaultManagerTest_GetSnapshotsErrorResponse, TEST_FaultManagerTest_GetSnapshotsInvalidJsonFallback, TEST_FaultManagerTest_GetSnapshotsServiceNotAvailable, TEST_FaultManagerTest_GetSnapshotsSuccessWithTopicFilter, TEST_FaultManagerTest_GetSnapshotsSuccessWithValidJson, TEST_FaultManagerTest_GetSnapshotsUsesConfiguredFaultManagerNamespace, TEST_RosbagCaptureTest_ConstructorAcceptsMcapFormat, TEST_RosbagCaptureTest_ConstructorRequiresValidNode, TEST_RosbagCaptureTest_ConstructorRequiresValidStorage, TEST_RosbagCaptureTest_ConstructorSucceedsWithValidParams, TEST_RosbagCaptureTest_ConstructorThrowsOnInvalidFormat, TEST_RosbagCaptureTest_ConstructorWithDisabledRosbag, TEST_RosbagCaptureTest_IsEnabledReturnsConfigState, TEST_SnapshotCaptureTest_BackgroundCaptureInitializesSubscriptions, TEST_SnapshotCaptureTest_ConfigAccessorReturnsCorrectValues, TEST_SnapshotCaptureTest_ConstructorRequiresValidNode, TEST_SnapshotCaptureTest_ConstructorRequiresValidStorage, TEST_SnapshotCaptureTest_ConstructorSucceedsWithValidParams, TEST_SnapshotCaptureTest_DisabledCaptureSkipsProcessing, TEST_SnapshotCaptureTest_EmptyConfigurationHandledGracefully, TEST_SnapshotCaptureTest_InvalidRegexPatternIsSkipped, TEST_SnapshotCaptureTest_IsEnabledReturnsConfigState, TEST_SnapshotCaptureTest_MultipleValidPatternsCompiled, TEST_SnapshotCaptureTest_OnDemandCaptureHandlesNonExistentTopic, TEST_SqliteFaultStorageTest_ClearFaultDeletesAssociatedSnapshots, TEST_SqliteFaultStorageTest_FilterSnapshotsByTopic, TEST_SqliteFaultStorageTest_MultipleSnapshotsForSameFault, TEST_SqliteFaultStorageTest_NoSnapshotsForUnknownFault, TEST_SqliteFaultStorageTest_StoreAndRetrieveSnapshot, TEST_TestFaultManagerIntegration_test_16_snapshot_capture_on_fault_confirmation, TEST_TestFaultManagerIntegration_test_17_get_snapshots_nonexistent_fault, TEST_TestFaultManagerIntegration_test_18_get_snapshots_empty_fault_code, TEST_TestFaultManagerIntegration_test_19_snapshot_with_topic_filter, TEST_TestFaultManagerIntegration_test_20_snapshot_config_loads_patterns, TEST_TestSnapshotsApi_test_root_endpoint_excludes_legacy_snapshots, TEST_TopicResolutionTest_DefaultTopicsUsedAsFallback, TEST_TopicResolutionTest_FaultSpecificHasHighestPriority, TEST_TopicResolutionTest_PatternMatchUsedWhenNoFaultSpecific

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.