Additional comments and logging

Author: JustinGrote

src/PowerShellEditorServices/Services/TextDocument/ScriptFile.cs

@@ -110,6 +110,9 @@ public Token[] ScriptTokens
 
         internal ReferenceTable References { get; }
 
+        /// <summary>
+        /// Indicates whether the file is currently open in the editor. PSES may open files for analysis that aren't actually visible in the editor.
+        /// </summary>
         internal bool IsOpen { get; set; }
 
         #endregion

src/PowerShellEditorServices/Services/Workspace/WorkspaceService.cs

@@ -302,7 +302,14 @@ public void CloseFile(ScriptFile scriptFile)
             Validate.IsNotNull(nameof(scriptFile), scriptFile);
 
             string keyName = GetFileKey(scriptFile.DocumentUri);
-            workspaceFiles.TryRemove(keyName, out ScriptFile _);
+            if (workspaceFiles.TryRemove(keyName, out ScriptFile _))
+            {
+                logger.LogDebug("Closed file: " + scriptFile.DocumentUri);
+            }
+            else
+            {
+                logger.LogWarning("Tried to close file that was not open: " + scriptFile.DocumentUri);
+            }
         }
 
         /// <summary>