Implement samm-cli version management

Author: andreas-wirth

extension/README.md

@@ -4,16 +4,19 @@ VS Code extension for the Turtle language server. The extension supports prefix
 
 ## Requirements
 
-- Java must be available in `PATH`.
-- The server project must be checked out next to this extension at `../lsp-server`.
-- Build the Maven server JAR before launching the extension:
+- A Turtle/SAMM language server release must be available from a GitHub repository URL configured in VS Code.
+- Java must be available in `PATH` if the downloaded release asset is a JAR.
 
-```bash
-cd ../lsp-server
-mvn package
-```
+## Configuration
+
+- `turtle.languageServerSettings.serverPort`
+  - TCP port used for the socket connection to the server.
+- `turtle.languageServerSettings.automaticUpdateCheck`
+  - If enabled, checks whether a newer GitHub release is available when a release-based executable is selected.
 
-The extension starts the server from `../lsp-server/target/lsp-server.jar`.
+Use the command `Turtle: Select SAMM-CLI Executable` to choose either:
+- one of the latest 10 SAMM-CLI GitHub releases, or
+- a custom executable path from your local file system.
 
 ## Features
 
@@ -29,13 +32,12 @@ The extension starts the server from `../lsp-server/target/lsp-server.jar`.
 
 ## Run The Server And Extension Together
 
-1. Build the server in `../lsp-server` with `mvn package`.
-2. In this extension project, install dependencies with `npm install`.
-3. Compile the extension with `npm run compile`.
-4. Press `F5` in VS Code to open an Extension Development Host.
-5. Open a Turtle file such as [samples/valid.ttl](samples/valid.ttl) or your Aspect model file.
+1. In this extension project, install dependencies with `npm install`.
+2. Compile the extension with `npm run build`.
+3. Press `F5` in VS Code to open an Extension Development Host.
+4. Open a Turtle file such as [samples/valid.ttl](samples/valid.ttl) or your Aspect model file.
 
-If the server JAR is missing, the extension shows an error and does not start the language client.
+If the server cannot be downloaded or started, the extension shows an error and leaves a detailed message in the Turtle LSP output channel.
 
 ## Validation Behavior
 
@@ -62,6 +64,8 @@ When each validation runs:
 
 - `Turtle LSP: Validate Aspect Model Now`
   - Sends a server request for the active Turtle document.
+- `Turtle: Select SAMM-CLI Executable`
+  - Opens a quick pick with the latest 10 GitHub releases and a custom-path option.
 
 ## UX During Long-Running Validation