add my comments

Author: chadparker

Tool/Sources/BuiltinExtension/BuiltinExtensionWorkspacePlugin.swift

@@ -9,6 +9,7 @@ public final class BuiltinExtensionWorkspacePlugin: WorkspacePlugin {
         super.init(workspace: workspace)
     }
 
+    // this calls Copilot notifyOpenTextDocument
     override public func didOpenFilespace(_ filespace: Filespace) {
         notifyOpenFile(filespace: filespace)
     }
@@ -32,6 +33,7 @@ public final class BuiltinExtensionWorkspacePlugin: WorkspacePlugin {
         }
     }
 
+    // this calls Copilot notifyOpenTextDocument
     public func notifyOpenFile(filespace: Filespace) {
         Task {
             guard filespace.isTextReadable else { return }

Tool/Sources/GitHubCopilotService/GitHubCopilotExtension.swift

@@ -42,6 +42,7 @@ public final class GitHubCopilotExtension: BuiltinExtension {
 
     public func workspaceDidClose(_: WorkspaceInfo) {}
 
+    // this calls Copilot notifyOpenTextDocument
     public func workspace(_ workspace: WorkspaceInfo, didOpenDocumentAt documentURL: URL) {
         guard isLanguageServerInUse else { return }
         // check if file size is larger than 15MB, if so, return immediately

Tool/Sources/GitHubCopilotService/LanguageServer/GitHubCopilotService.swift

@@ -36,6 +36,7 @@ public protocol GitHubCopilotSuggestionServiceType {
     func notifyShown(_ completion: CodeSuggestion) async
     func notifyAccepted(_ completion: CodeSuggestion, acceptedLength: Int?) async
     func notifyRejected(_ completions: [CodeSuggestion]) async
+    // tells Copilot LSP that a file has been opened
     func notifyOpenTextDocument(fileURL: URL, content: String) async throws
     func notifyChangeTextDocument(fileURL: URL, content: String, version: Int) async throws
     func notifyCloseTextDocument(fileURL: URL) async throws

Tool/Sources/XcodeInspector/XcodeInspector.swift

@@ -140,9 +140,11 @@ public final class XcodeInspector: ObservableObject {
             latestNonRootWorkspaceURL = nil
         }
 
+        // finds running Xcode instances
         let runningApplications = NSWorkspace.shared.runningApplications
         xcodes = runningApplications
             .filter { $0.isXcode }
+            // creates a XcodeAppInstanceInspector for each Xcode instance
             .map(XcodeAppInstanceInspector.init(runningApplication:))
         let activeXcode = xcodes.first(where: \.isActive)
         latestActiveXcode = activeXcode ?? xcodes.first
@@ -160,6 +162,7 @@ public final class XcodeInspector: ObservableObject {
             }
 
             await withThrowingTaskGroup(of: Void.self) { [weak self] group in
+                // activation
                 group.addTask { [weak self] in // Did activate app
                     let sequence = NSWorkspace.shared.notificationCenter
                         .notifications(named: NSWorkspace.didActivateApplicationNotification)
@@ -193,6 +196,7 @@ public final class XcodeInspector: ObservableObject {
                     }
                 }
 
+                // termination
                 group.addTask { [weak self] in // Did terminate app
                     let sequence = NSWorkspace.shared.notificationCenter
                         .notifications(named: NSWorkspace.didTerminateApplicationNotification)
@@ -242,6 +246,7 @@ public final class XcodeInspector: ObservableObject {
                     }
                 }
 
+                // accessibility API issues
                 group.addTask { [weak self] in // malfunctioning
                     let sequence = NotificationCenter.default
                         .notifications(named: .accessibilityAPIMalfunctioning)
@@ -267,6 +272,10 @@ public final class XcodeInspector: ObservableObject {
         }
     }
 
+    // Get the focused UI element
+    // Determine if it's a source editor
+    // Monitor for focus changes
+
     @XcodeInspectorActor
     private func setActiveXcode(_ xcode: XcodeAppInstanceInspector) {
         previousActiveApplication = activeApplication
@@ -279,9 +288,12 @@ public final class XcodeInspector: ObservableObject {
 
         activeXcode = xcode
         latestActiveXcode = xcode
+        // active document
         activeDocumentURL = xcode.documentURL
+        // focused window
         focusedWindow = xcode.focusedWindow
         completionPanel = xcode.completionPanel
+        // project root
         activeProjectRootURL = xcode.projectRootURL
         activeWorkspaceURL = xcode.workspaceURL
         focusedWindow = xcode.focusedWindow
@@ -304,6 +316,7 @@ public final class XcodeInspector: ObservableObject {
             }
 
             focusedElement = getFocusedElementAndRecordStatus(xcode.appElement)
+            // focused editor
             if let editorElement = focusedElement, editorElement.isSourceEditor {
                 focusedEditor = .init(
                     runningApplication: xcode.runningApplication,