Update version to 2.0.4 and improve logging system

- Update version to 2.0.4 in package.json and CHANGELOG.md
- Upgrade vscode-languageclient and vscode-languageserver to next.15 and next.13
- Add output channels for VSCode log level control integration
- Convert file paths to file:// URLs for Windows compatibility in dynamic imports
- Improve logging verbosity levels (info → debug for routine operations)
- Add tip in README about controlling AGLint logging via VSCode's log level settings
- Update

Author: totadavid95

CHANGELOG.md

@@ -7,6 +7,16 @@ The format is based on [Keep a Changelog], and this project adheres to [Semantic
 [Keep a Changelog]: https://keepachangelog.com/en/1.0.0/
 [Semantic Versioning]: https://semver.org/spec/v2.0.0.html
 
+## [2.0.4] (prerelease) - 2025-11-28
+
+### Changed
+
+- Improved logging.
+
+### Fixed
+
+- Loading AGLint on Windows.
+
 ## [2.0.3] (prerelease) - 2025-11-28
 
 ### Added

README.md

@@ -107,6 +107,9 @@ This extension provides the following configuration options:
 | `adblock.enableInMemoryAglintCache` | ⚠️ **Experimental**: Enable or disable in-memory caching of linting results for better performance. | `false` | `true`, `false` |
 <!--markdownlint-enable MD013-->
 
+> **💡 Tip**: To control AGLint logging verbosity, use VSCode's built-in log level control:
+> Open Command Palette (**Cmd+Shift+P**) → **Developer: Set Log Level...** → Select **AGLint**
+
 ### GitHub Linguist support
 
 GitHub supports adblock syntax officially via the [Linguist][linguist] library. Our extension provides a

client/package.json

@@ -7,7 +7,7 @@
     "private": true,
     "dependencies": {
         "valibot": "^1.1.0",
-        "vscode-languageclient": "^8.0.2"
+        "vscode-languageclient": "10.0.0-next.15"
     },
     "devDependencies": {
         "@types/vscode": "^1.74.0"

client/src/extension.ts

@@ -228,6 +228,9 @@ function createClientForFolder(folder: WorkspaceFolder, serverModule: string): L
             workspaceFolder: { uri: folder.uri.toString(), name: folder.name },
         },
 
+        // Create output channel - this makes the extension appear in "Developer: Set Log Level"
+        outputChannel: Window.createOutputChannel(`${CLIENT_NAME} (${folder.name})`, { log: true }),
+
         synchronize: {
             fileEvents: [
                 Workspace.createFileSystemWatcher(
@@ -319,6 +322,8 @@ function ensureDefaultClient(serverModule: string) {
     const clientOptions: LanguageClientOptions = {
         documentSelector: [{ scheme: FileScheme.Untitled, language: LANGUAGE_ID }],
         progressOnInitialization: true,
+        // Create output channel - this makes the extension appear in "Developer: Set Log Level"
+        outputChannel: Window.createOutputChannel(`${CLIENT_NAME} (untitled)`, { log: true }),
     };
 
     // Give the untitled client a unique ID too

client/tsconfig.json

@@ -1,8 +1,9 @@
 {
 	"compilerOptions": {
-		"module": "CommonJS",
+		"module": "es2020",
 		"target": "es2020",
 		"lib": ["es2020"],
+		"moduleResolution": "bundler",
 		"outDir": "out",
 		"rootDir": "src",
 		"sourceMap": true,

package.json

@@ -2,7 +2,7 @@
     "name": "adblock",
     "displayName": "Adblock/AdGuard/uBlock filters grammar",
     "description": "VS code extension that adds support for ad blocking rules syntax.",
-    "version": "2.0.3",
+    "version": "2.0.4",
     "publisher": "adguard",
     "icon": "icons/aglint_128x128.png",
     "main": "./client/out/extension",

pnpm-lock.yaml

@@ -11,8 +11,7 @@
         "debounce": "^3.0.0",
         "fast-glob": "^3.3.3",
         "preferred-pm": "^4.1.1",
-        "resolve-from": "^5.0.0",
-        "vscode-languageserver": "^8.0.2",
+        "vscode-languageserver": "10.0.0-next.13",
         "vscode-languageserver-textdocument": "^1.0.8",
         "vscode-uri": "^3.1.0",
         "yaml": "^2.7.1"

server/package.json

@@ -86,7 +86,7 @@ export class AglintContext {
             return undefined;
         }
 
-        connection.console.info(`AGLint module loaded (version: ${aglint.version})`);
+        connection.console.info(`AGLint module loaded from ${aglint.modulePath} (version: ${aglint.version})`);
 
         const pathAdapter = new aglint.cli.NodePathAdapter();
         const fsAdapter = new LSPFileSystemAdapter(documents);
@@ -96,7 +96,7 @@ export class AglintContext {
             printTimestamps: false,
             printElapsed: false,
             colors: false,
-            logger: (message) => connection.console.info(`[AGLint debug] ${message}`),
+            logger: (message) => connection.console.debug(`[AGLint debugger] ${message}`),
         });
 
         const configResolver = new aglint.cli.ConfigResolver(

server/src/context/aglint-context.ts

@@ -56,6 +56,8 @@ const LINT_FILE_DEBOUNCE_DELAY = 100;
  */
 const connection = createConnection(ProposedFeatures.all);
 
+connection.console.info(`AGLint Language Server starting (Node.js ${process.version})`);
+
 /**
  * Create a simple text document manager.
  */
@@ -163,7 +165,7 @@ connection.onInitialize(async (params: InitializeParams) => {
     } else {
         message += 'without workspace root';
     }
-    connection.console.log(message);
+    connection.console.debug(message);
 
     // TODO: Define the capabilities of the language server here
     const result: InitializeResult = {
@@ -180,7 +182,7 @@ connection.onInitialize(async (params: InitializeParams) => {
     // we do not need to handle workspace folder changes.
     if (hasWorkspaceFolderCapability) {
         connection.workspace.onDidChangeWorkspaceFolders(() => {
-            connection.console.log('Workspace folder change event received (ignored by per-folder server instance).');
+            connection.console.warn('Workspace folder change event received (ignored by per-folder server instance).');
         });
     }
 
@@ -342,15 +344,15 @@ async function lintFile(textDocument: TextDocument): Promise<void> {
             const cachedDiagnostics = lintCache.get(cacheKey);
             if (cachedDiagnostics) {
                 const duration = Date.now() - startTime;
-                connection.console.info(
+                connection.console.debug(
                     `Linting completed for: ${documentPath} (from cache, ${duration}ms)`,
                 );
                 connection.sendDiagnostics({ uri: textDocument.uri, diagnostics: cachedDiagnostics });
                 return;
             }
         }
 
-        connection.console.info(`Linting started for: ${documentPath}`);
+        connection.console.debug(`Linting file: ${documentPath}`);
 
         const linterRunOptions: LinterRunOptions = {
             fileProps: {
@@ -377,7 +379,7 @@ async function lintFile(textDocument: TextDocument): Promise<void> {
         }
 
         const duration = Date.now() - startTime;
-        connection.console.info(`Linting completed for: ${documentPath} (${duration}ms)`);
+        connection.console.debug(`Linting completed for: ${documentPath} (${duration}ms)`);
 
         connection.sendDiagnostics({ uri: textDocument.uri, diagnostics });
     } catch (error: unknown) {
@@ -415,7 +417,7 @@ const parseConfigCommentTolerant = (rule: string): ConfigCommentRule | null => {
     try {
         return ConfigCommentRuleParser.parse(rule);
     } catch (error: unknown) {
-        connection.console.error(`'${rule}' is not a valid AGLint config comment rule: ${getErrorMessage(error)}`);
+        connection.console.debug(`'${rule}' is not a valid AGLint config comment rule: ${getErrorMessage(error)}`);
         return null;
     }
 };
@@ -802,11 +804,11 @@ async function pullSettings() {
     // If AGLint is disabled, clean up and return early
     if (!settings.enableAglint) {
         removeAllDiagnostics();
-        connection.console.info('AGLint is disabled');
+        connection.console.debug('AGLint is disabled');
         return;
     }
 
-    connection.console.info('AGLint integration is enabled');
+    connection.console.debug('AGLint integration is enabled');
 
     // Initialize AGLint context if not already initialized
     if (!aglintContext) {
@@ -824,7 +826,7 @@ async function pullSettings() {
         }
     } else if (previousEnableDebug !== settings.enableAglintDebug) {
         // Handle debug setting change
-        connection.console.info(`AGLint debug mode changed: ${settings.enableAglintDebug}`);
+        connection.console.info(`AGLint debug mode ${settings.enableAglintDebug ? 'enabled' : 'disabled'}`);
 
         if (settings.enableAglintDebug) {
             aglintContext.debuggerInstance.enable();
@@ -833,6 +835,17 @@ async function pullSettings() {
         }
     }
 
+    // Log cache setting changes
+    if (previousEnableCache !== settings.enableInMemoryAglintCache) {
+        if (settings.enableInMemoryAglintCache) {
+            connection.console.info('In-memory linting cache enabled');
+        } else {
+            connection.console.info('In-memory linting cache disabled');
+            lintCache.clear();
+            connection.console.debug('Cache cleared');
+        }
+    }
+
     await refreshLinter();
 }
 
@@ -874,7 +887,7 @@ connection.onInitialized(async () => {
 
     if (hasWorkspaceFolderCapability) {
         connection.workspace.onDidChangeWorkspaceFolders(() => {
-            connection.console.log('Workspace folder change event received.');
+            connection.console.warn('Workspace folder change event received.');
         });
     }
 
@@ -894,5 +907,3 @@ documents.listen(connection);
 
 // Listen on the connection
 connection.listen();
-
-connection.console.info(`AGLint Node.js Language Server running in node ${process.version}`);