jetls-client: Prepare v0.2.0 release with migration support (#318)

Update jetls-client to v0.2.0 with enhanced update notification system that
guides users through the breaking changes in JETLS installation method.

Changes:
- Update CHANGELOG.md with v0.2.0 release notes including breaking changes
  and installation steps
- Implement three-tier notification system in checkForUpdates():
  1. First-time installation: Welcome message with 'Install JETLS' button
     that runs the new installation command
  2. v0.1.x -> v0.2.0 upgrade: Warning message about breaking changes with
     'Reinstall JETLS' button and link to migration guide (CHANGELOG.md#v020)
  3. Normal updates: Standard update notification with 'Update JETLS' button
- All notifications provide direct terminal commands or documentation links
  for easy user action

The v0.2.0 release requires users to reinstall JETLS using the new
`jetls` executable app method instead of the previous runserver.jl approach.
The notification system ensures smooth migration for existing users while
providing clear onboarding for new users.

Author: aviatesk

jetls-client/CHANGELOG.md

@@ -10,8 +10,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 > [!note]
 >
 > - Commit: [`HEAD`](https://github.com/aviatesk/JETLS.jl/commit/HEAD)
+
+## [v0.2.0]
+
+[v0.2.0]: https://github.com/aviatesk/JETLS.jl/compare/b0a4a4c...HEAD
+
+> [!note]
+>
 > - Diff: [`b0a4a4c...HEAD`](https://github.com/aviatesk/JETLS.jl/compare/b0a4a4c...HEAD)
 
+> [!warning]
+> **Breaking changes**: JETLS installation method has changed significantly.
+> You must reinstall JETLS using the new `jetls` executable app.
+> See the [installation steps](#installation-steps) below.
+
+### Installation steps
+
+1. Install the `jetls` executable app:
+   ```bash
+   julia -e 'using Pkg; Pkg.Apps.add("https://github.com/aviatesk/JETLS.jl#release")'
+   ```
+2. Make sure `~/.julia/bin` is in your `PATH`
+3. Restart VSCode
+
 ### Changed
 
 - JETLS launch configuration has been significantly updated with the migration to the `jetls` executable app.

jetls-client/jetls-client.ts

@@ -111,7 +111,8 @@ function createTimeoutHandler(
 
 function getServerConfig(): ServerConfig {
   const config = vscode.workspace.getConfiguration("jetls-client");
-  const defaultExecutable = process.platform === "win32" ? "jetls.exe" : "jetls";
+  const defaultExecutable =
+    process.platform === "win32" ? "jetls.exe" : "jetls";
   const executable = config.get<ExecutableConfig>("executable", {
     path: defaultExecutable,
     threads: "auto",
@@ -150,7 +151,8 @@ async function startLanguageServer() {
     baseCommand = cmd;
     baseArgs = args;
   } else {
-    const defaultExecutable = process.platform === "win32" ? "jetls.exe" : "jetls";
+    const defaultExecutable =
+      process.platform === "win32" ? "jetls.exe" : "jetls";
     baseCommand = serverConfig.executable.path || defaultExecutable;
     const threads = serverConfig.executable.threads || "auto";
     baseArgs = [`--threads=${threads}`, "--"];
@@ -466,32 +468,99 @@ async function checkForUpdates(context: ExtensionContext): Promise<void> {
     ?.packageJSON.version;
   const previousVersion = context.globalState.get<string>("version");
 
-  if (currentVersion && previousVersion && currentVersion !== previousVersion) {
+  if (currentVersion && !previousVersion) {
+    // First-time installation
     const message =
-      "JETLS Client has been updated! Please make sure to update the JETLS server as well.";
-    const updateButton = "Update JETLS";
-    const docsButton = "View Changelog";
+      "Welcome to JETLS Client! To use this extension, you need to install the JETLS executable. " +
+      "Click 'Install JETLS' to get started.";
+    const installButton = "Install JETLS";
+    const docsButton = "View Installation Guide";
 
     const selection = await vscode.window.showInformationMessage(
       message,
-      updateButton,
+      installButton,
       docsButton,
     );
 
-    if (selection === updateButton) {
-      const terminal = vscode.window.createTerminal("Update JETLS");
+    if (selection === installButton) {
+      const terminal = vscode.window.createTerminal("Install JETLS");
       terminal.show();
       terminal.sendText(
-        'julia -e \'using Pkg; Pkg.Apps.update("JETLS")\'',
+        "julia -e 'using Pkg; Pkg.Apps.add(\"https://github.com/aviatesk/JETLS.jl#release\")'",
         true,
       );
     } else if (selection === docsButton) {
       vscode.env.openExternal(
         vscode.Uri.parse(
-          "https://github.com/aviatesk/JETLS.jl/blob/master/CHANGELOG.md",
+          "https://github.com/aviatesk/JETLS.jl/blob/master/jetls-client/README.md#getting-started",
         ),
       );
     }
+  } else if (
+    currentVersion &&
+    previousVersion &&
+    currentVersion !== previousVersion
+  ) {
+    // Update detected
+    if (
+      previousVersion.startsWith("0.1.") &&
+      currentVersion.startsWith("0.2.")
+    ) {
+      // Special handling for v0.1.x -> v0.2.0 breaking update
+      const message =
+        "JETLS Client v0.2.0 requires reinstalling JETLS with the new installation method. " +
+        "Click 'Reinstall JETLS' to run the installation command.";
+      const reinstallButton = "Reinstall JETLS";
+      const migrationGuideButton = "View Migration Guide";
+
+      const selection = await vscode.window.showWarningMessage(
+        message,
+        reinstallButton,
+        migrationGuideButton,
+      );
+
+      if (selection === reinstallButton) {
+        const terminal = vscode.window.createTerminal("Reinstall JETLS");
+        terminal.show();
+        terminal.sendText(
+          "julia -e 'using Pkg; Pkg.Apps.add(\"https://github.com/aviatesk/JETLS.jl#release\")'",
+          true,
+        );
+      } else if (selection === migrationGuideButton) {
+        vscode.env.openExternal(
+          vscode.Uri.parse(
+            "https://github.com/aviatesk/JETLS.jl/blob/master/jetls-client/CHANGELOG.md#v020",
+          ),
+        );
+      }
+    } else {
+      // Normal update
+      const message =
+        "JETLS Client has been updated! Please make sure to update the JETLS server as well.";
+      const updateButton = "Update JETLS";
+      const changelogButton = "View Changelog";
+
+      const selection = await vscode.window.showInformationMessage(
+        message,
+        updateButton,
+        changelogButton,
+      );
+
+      if (selection === updateButton) {
+        const terminal = vscode.window.createTerminal("Update JETLS");
+        terminal.show();
+        terminal.sendText(
+          "julia -e 'using Pkg; Pkg.Apps.update(\"JETLS\")'",
+          true,
+        );
+      } else if (selection === changelogButton) {
+        vscode.env.openExternal(
+          vscode.Uri.parse(
+            "https://github.com/aviatesk/JETLS.jl/blob/master/jetls-client/CHANGELOG.md",
+          ),
+        );
+      }
+    }
   }
 
   if (currentVersion) {