Stabilize shared CI verification

Author: MarcusJRLee

Tests/HardwareControllerAudioBoundaryTests/audio_engine_exception_boundary_test.swift

@@ -2,6 +2,7 @@ import AVFoundation
 import HardwareControllerAudioBoundary
 import Testing
 
+@Suite(.serialized)
 struct AudioEngineExceptionBoundaryTest {
   /// Converts a duplicate-tap exception into a recoverable error.
   @Test

Tests/HardwareControllerMacTests/controller_runtime_test.swift

@@ -440,7 +440,13 @@ struct ControllerRuntimeTest {
     )
   }
 
-  @Test
+  @Test(
+    .enabled(
+      if: ProcessInfo.processInfo.environment[
+        "HC_RUN_HID_PERFORMANCE"
+      ] == "1"
+    )
+  )
   func tenThousandTransitionSoakMeetsDispatchBudget() {
     let executor = RecordingExecutor()
     let snapshots = SnapshotRecorder()

Tests/HardwareControllerMacTests/voice_history_reconciler_test.swift

@@ -71,6 +71,7 @@ struct VoiceHistoryReconcilerTest {
     )
     let document = historyDocument(sessionID: sessionID)
     try await record(document, in: try #require(history))
+    _ = try await #require(history).recentSessions(limit: 1)
     let finalURL = root.appending(path: "audio/\(sessionID).caf")
     let quarantineFilename =
       ".expiring_\(sessionID.uuidString)_\(UUID().uuidString).caf"

docs/contributor_guide.md

@@ -12,6 +12,8 @@
 Demo mode uses deterministic process data and does not request Accessibility,
 Microphone, Speech Recognition, or hardware access. Tests replace process
 boundaries and skip opt-in system checks unless their environment flag is set.
+`scripts/check.sh` runs the required HID latency soak in its own test process so
+unrelated parallel suites cannot create scheduler outliers.
 
 ## Source map
 

scripts/build_release.sh

@@ -237,6 +237,8 @@ main() {
     Sources/HardwareControllerAudioBoundary/audio_engine_exception_boundary.m \
     Sources/HardwareControllerAudioBoundary/include/audio_engine_exception_boundary.h
   swift test
+  HC_RUN_HID_PERFORMANCE=1 swift test \
+    --filter tenThousandTransitionSoakMeetsDispatchBudget
   zsh -n scripts/*.sh
   plutil -lint packaging/*.plist >/dev/null
 

scripts/check.sh

@@ -12,6 +12,8 @@ xcrun clang-format --dry-run --Werror \
   Sources/HardwareControllerAudioBoundary/include/audio_engine_exception_boundary.h
 zsh -n scripts/*.sh
 swift test
+HC_RUN_HID_PERFORMANCE=1 swift test \
+  --filter tenThousandTransitionSoakMeetsDispatchBudget
 swift build -c release --product HardwareController
 scripts/build_release_test.sh
 scripts/notarize_release_test.sh