refactor: Упрощены комментарии и улучшена документация по исключению путей

- Обновлены комментарии в `BSLWorkspaceService`, `LanguageServerConfiguration` и `PathExclusionUtils` для более ясного описания обработки событий создания и изменения файлов, а также логики исключения путей.
- Упрощены описания методов и параметров, улучшена читаемость кода.
- Обновлены тесты для проверки функциональности исключения путей, включая новые сценарии.

Author: johnnyshut

src/main/java/com/github/_1c_syntax/bsl/languageserver/BSLWorkspaceService.java

@@ -144,13 +144,8 @@ private void handleDeletedFileEvent(URI uri) {
   }
 
   /**
-   * Обрабатывает событие создания нового файла в файловой системе.
-   * <p>
-   * Добавляет файл в контекст сервера. Если файл не открыт в редакторе,
-   * выполняет его парсинг и анализ, после чего сразу очищает вторичные данные
-   * для экономии памяти. Для открытых файлов обработка пропускается,
-   * т.к. их содержимое управляется через события textDocument/didOpen.
-   * Файлы из каталогов из excludePaths не добавляются.
+   * Обрабатывает событие создания файла: добавляет в контекст (кроме путей из excludePaths),
+   * при необходимости парсит и очищает вторичные данные.
    *
    * @param uri URI созданного файла
    */
@@ -168,17 +163,10 @@ private void handleCreatedFileEvent(URI uri) {
   }
 
   /**
-   * Обрабатывает событие изменения файла в файловой системе.
-   * <p>
-   * Если файл уже есть в контексте сервера и не открыт в редакторе,
-   * перечитывает его содержимое с диска, выполняет повторный парсинг и анализ,
-   * после чего очищает вторичные данные. Для открытых файлов обработка пропускается,
-   * т.к. их актуальное содержимое управляется через события textDocument/didChange.
-   * <p>
-   * Если файл отсутствует в контексте, добавляет его и обрабатывает аналогично созданному.
-   * Файлы из каталогов из excludePaths не добавляются в контекст.
+   * Обрабатывает событие изменения файла: перечитывает с диска или добавляет в контекст
+   * (пути из excludePaths не добавляются), при необходимости парсит и очищает вторичные данные.
    *
-   * @param uri URI измененного файла
+   * @param uri URI изменённого файла
    */
   private void handleChangedFileEvent(URI uri) {
     var documentContext = serverContext.getDocument(uri);
@@ -196,6 +184,7 @@ private void handleChangedFileEvent(URI uri) {
     }
   }
 
+  /** Проверяет, входит ли путь по uri в excludePaths относительно корня конфигурации. */
   private boolean isExcludedPath(URI uri) {
     var root = serverContext.getConfigurationRoot();
     var patterns = configuration.getExcludePaths();

src/main/java/com/github/_1c_syntax/bsl/languageserver/configuration/LanguageServerConfiguration.java

@@ -121,11 +121,8 @@ public class LanguageServerConfiguration {
   private Path configurationRoot;
 
   /**
-   * Список путей (каталогов или glob-паттернов) для исключения из индексации.
-   * <p>
-   * Поддерживаются простые имена каталогов (например, ".git", "node_modules")
-   * и glob-паттерны. Путь считается исключённым, если он совпадает с любым из
-   * паттернов относительно корня конфигурации.
+   * Паттерны путей для исключения из индексации (простые имена каталогов или glob).
+   * Сопоставление выполняется относительно корня конфигурации.
    */
   private List<String> excludePaths = new ArrayList<>();
 

src/main/java/com/github/_1c_syntax/bsl/languageserver/utils/PathExclusionUtils.java

@@ -36,16 +36,19 @@
 public final class PathExclusionUtils {
 
   private PathExclusionUtils() {
-    // utility
   }
 
   /**
    * Проверяет, исключён ли путь из индексации по списку паттернов.
+   * <p>
+   * Путь приводится к относительному от {@code root}. Если путь не является подпутём root,
+   * возвращается false. Для простых имён (без «/» и «*») проверяется вхождение сегмента;
+   * для glob-паттернов используется PathMatcher.
    *
-   * @param root     корень конфигурации (относительно него проверяется путь); может быть null
-   * @param path    абсолютный путь к файлу или каталогу
-   * @param patterns список паттернов (имена каталогов или glob)
-   * @return true, если путь следует исключить
+   * @param root     корень, относительно которого проверяется путь; может быть null
+   * @param path     абсолютный путь к файлу или каталогу
+   * @param patterns список паттернов (имена каталогов или glob); может быть null
+   * @return true, если путь совпадает с одним из паттернов
    */
   public static boolean isExcluded(@Nullable Path root, Path path, @Nullable List<String> patterns) {
     if (root == null || patterns == null || patterns.isEmpty()) {
@@ -56,7 +59,6 @@ public static boolean isExcluded(@Nullable Path root, Path path, @Nullable List<
     try {
       relativePath = root.relativize(path);
     } catch (IllegalArgumentException e) {
-      // path не внутри root — не исключаем
       return false;
     }
 
@@ -73,9 +75,8 @@ public static boolean isExcluded(@Nullable Path root, Path path, @Nullable List<
   }
 
   /**
-   * Проверяет совпадение пути с паттерном.
-   * Простые имена (без / и *) — проверка по сегментам пути (кроссплатформенно).
-   * Glob-паттерны — через PathMatcher с нормализацией пути к "/".
+   * Сопоставляет относительный путь с паттерном: для простых имён — по сегментам,
+   * для glob — через PathMatcher (путь нормализуется к «/»).
    */
   private static boolean matchesPattern(Path relativePath, String pattern) {
     if (!pattern.contains("/") && !pattern.contains("*")) {
@@ -91,9 +92,7 @@ private static boolean matchesPattern(Path relativePath, String pattern) {
     return matcher.matches(pathForGlobMatching(relativePath));
   }
 
-  /**
-   * Нормализует путь к представлению с прямыми слешами для сопоставления с glob-паттерном.
-   */
+  /** Собирает путь из сегментов с разделителем «/» для кроссплатформенного glob. */
   private static Path pathForGlobMatching(Path path) {
     if (path.getNameCount() == 0) {
       return path;

src/test/java/com/github/_1c_syntax/bsl/languageserver/context/ServerContextTest.java

@@ -132,15 +132,12 @@ void testPopulateContext() {
 
   @Test
   void testPopulateContextExcludesPathsFromConfig() {
-    // given: excludePaths исключает каталог CommonModules
     Path path = Absolute.path(PATH_TO_METADATA);
     serverContext.setConfigurationRoot(path);
     configuration.setExcludePaths(List.of("CommonModules"));
 
-    // when
     serverContext.populateContext();
 
-    // then: документы из CommonModules не попадают в контекст
     var documents = serverContext.getDocuments();
     assertThat(documents).isNotEmpty();
     var commonModuleUris = documents.keySet().stream()

src/test/java/com/github/_1c_syntax/bsl/languageserver/utils/PathExclusionUtilsTest.java

@@ -22,8 +22,6 @@
 package com.github._1c_syntax.bsl.languageserver.utils;
 
 import org.junit.jupiter.api.Test;
-import org.junit.jupiter.api.condition.EnabledOnOs;
-import org.junit.jupiter.api.condition.OS;
 
 import java.nio.file.Path;
 import java.util.ArrayList;
@@ -55,10 +53,8 @@ void isExcludedReturnsFalseWhenPatternsIsEmpty() {
 
   @Test
   void isExcludedReturnsFalseWhenPathIsOutsideRoot() {
-    // path не является подпутём root — на разных дисках (Windows) relativize бросает IllegalArgumentException
     Path root = Path.of("project").toAbsolutePath();
     Path path = root.resolve("sibling").resolve("file.bsl");
-    // root = .../project, path = .../project/sibling/file.bsl — path внутри root, паттерн "other" не совпадает
     assertThat(PathExclusionUtils.isExcluded(root, path, List.of("other"))).isFalse();
   }
 
@@ -70,10 +66,9 @@ void isExcludedReturnsTrueWhenPathMatchesSimpleNamePattern() {
   }
 
   @Test
-  @EnabledOnOs({OS.LINUX, OS.MAC})
   void isExcludedReturnsTrueWhenPathMatchesGlobPattern() {
     Path root = Path.of("project").toAbsolutePath();
-    Path path = root.resolve(".git").resolve("refs").resolve("HEAD");
+    Path path = root.resolve("repo").resolve(".git").resolve("refs").resolve("HEAD");
     assertThat(PathExclusionUtils.isExcluded(root, path, List.of("**/.git/**"))).isTrue();
   }