Improve logic for build graph generation status

`generateBuildGraph` was named misleadingly because the primary purpose of these tasks was to schedule indexing tasks and generating the build graph was just a necessary step for this. Also update it to take into account that multiple tasks scheduling indexing tasks might be running in parallel.

Author: ahoppen

Sources/SemanticIndex/SemanticIndexManager.swift

@@ -93,16 +93,16 @@ package enum IndexTaskStatus: Comparable {
 /// messages to the user, we only show the highest priority task.
 package enum IndexProgressStatus: Sendable {
   case preparingFileForEditorFunctionality
-  case generatingBuildGraph
+  case schedulingIndexing
   case indexing(preparationTasks: [BuildTargetIdentifier: IndexTaskStatus], indexTasks: [DocumentURI: IndexTaskStatus])
   case upToDate
 
   package func merging(with other: IndexProgressStatus) -> IndexProgressStatus {
     switch (self, other) {
     case (_, .preparingFileForEditorFunctionality), (.preparingFileForEditorFunctionality, _):
       return .preparingFileForEditorFunctionality
-    case (_, .generatingBuildGraph), (.generatingBuildGraph, _):
-      return .generatingBuildGraph
+    case (_, .schedulingIndexing), (.schedulingIndexing, _):
+      return .schedulingIndexing
     case (
       .indexing(let selfPreparationTasks, let selfIndexTasks),
       .indexing(let otherPreparationTasks, let otherIndexTasks)
@@ -162,9 +162,9 @@ package final actor SemanticIndexManager {
 
   private let testHooks: IndexTestHooks
 
-  /// The task to generate the build graph (resolving package dependencies, generating the build description,
-  /// ...). `nil` if no build graph is currently being generated.
-  private var generateBuildGraphTask: Task<Void, Never>?
+  /// The tasks to generate the build graph (resolving package dependencies, generating the build description,
+  /// ...) and to schedule indexing of modified tasks.
+  private var scheduleIndexingTasks: [UUID: Task<Void, Never>] = [:]
 
   private let preparationUpToDateTracker = UpToDateTracker<BuildTargetIdentifier>()
 
@@ -213,8 +213,8 @@ package final actor SemanticIndexManager {
     if inProgressPreparationTasks.values.contains(where: { $0.purpose == .forEditorFunctionality }) {
       return .preparingFileForEditorFunctionality
     }
-    if generateBuildGraphTask != nil {
-      return .generatingBuildGraph
+    if !scheduleIndexingTasks.isEmpty {
+      return .schedulingIndexing
     }
     let preparationTasks = inProgressPreparationTasks.mapValues { inProgressTask in
       return inProgressTask.task.isExecuting ? IndexTaskStatus.executing : IndexTaskStatus.scheduled
@@ -275,7 +275,8 @@ package final actor SemanticIndexManager {
     filesToIndex: [DocumentURI]?,
     indexFilesWithUpToDateUnit: Bool
   ) async {
-    generateBuildGraphTask = Task(priority: .low) {
+    let taskId = UUID()
+    let generateBuildGraphTask = Task(priority: .low) {
       await withLoggingSubsystemAndScope(subsystem: indexLoggingSubsystem, scope: "build-graph-generation") {
         await testHooks.buildGraphGenerationDidStart?()
         await self.buildSystemManager.waitForUpToDateBuildGraph()
@@ -308,9 +309,10 @@ package final actor SemanticIndexManager {
           }
         }
         await scheduleBackgroundIndex(files: filesToIndex, indexFilesWithUpToDateUnit: indexFilesWithUpToDateUnit)
-        generateBuildGraphTask = nil
+        scheduleIndexingTasks[taskId] = nil
       }
     }
+    scheduleIndexingTasks[taskId] = generateBuildGraphTask
     indexProgressStatusDidChange()
   }
 
@@ -322,12 +324,22 @@ package final actor SemanticIndexManager {
     await scheduleBuildGraphGenerationAndBackgroundIndexAllFiles(filesToIndex: nil, indexFilesWithUpToDateUnit: true)
   }
 
+  private func waitForBuildGraphGenerationTasks() async {
+    await withTaskGroup(of: Void.self) { taskGroup in
+      for generateBuildGraphTask in scheduleIndexingTasks.values {
+        taskGroup.addTask {
+          await generateBuildGraphTask.value
+        }
+      }
+    }
+  }
+
   /// Wait for all in-progress index tasks to finish.
   package func waitForUpToDateIndex() async {
     logger.info("Waiting for up-to-date index")
     // Wait for a build graph update first, if one is in progress. This will add all index tasks to `indexStatus`, so we
     // can await the index tasks below.
-    await generateBuildGraphTask?.value
+    await waitForBuildGraphGenerationTasks()
 
     await withTaskGroup(of: Void.self) { taskGroup in
       for (_, status) in inProgressIndexTasks {
@@ -356,7 +368,7 @@ package final actor SemanticIndexManager {
     )
     // If there's a build graph update in progress wait for that to finish so we can discover new files in the build
     // system.
-    await generateBuildGraphTask?.value
+    await waitForBuildGraphGenerationTasks()
 
     // Create a new index task for the files that aren't up-to-date. The newly scheduled index tasks will
     // - Wait for the existing index operations to finish if they have the same number of files.

Sources/SourceKitLSP/IndexProgressManager.swift

@@ -93,8 +93,8 @@ actor IndexProgressManager {
     case .preparingFileForEditorFunctionality:
       message = "Preparing current file"
       percentage = 0
-    case .generatingBuildGraph:
-      message = "Generating build graph"
+    case .schedulingIndexing:
+      message = "Scheduling tasks"
       percentage = 0
     case .indexing(preparationTasks: let preparationTasks, indexTasks: let indexTasks):
       // We can get into a situation where queuedIndexTasks < indexTasks.count if we haven't processed all

Tests/SourceKitLSPTests/BackgroundIndexingTests.swift

@@ -378,7 +378,7 @@ final class BackgroundIndexingTests: XCTestCase {
       XCTFail("Expected begin notification")
       return
     }
-    XCTAssertEqual(beginData.message, "Generating build graph")
+    XCTAssertEqual(beginData.message, "Scheduling tasks")
     let indexingWorkDoneProgressToken = beginNotification.token
 
     _ = try await project.testClient.nextNotification(