release: 2025-11-28

.github/workflows/release.yml

@@ -68,15 +68,8 @@ jobs:
       - name: Get release info
         id: release_info
         run: |
-          # Extract date and commit from the latest "release: YYYY-MM-DD" commit
-          COMMIT=$(git log --grep="^release:" -1 --format="%H" || echo "")
-          DATE=$(git log --grep="^release:" -1 --format="%s" | grep -oE '[0-9]{4}-[0-9]{2}-[0-9]{2}' || echo "")
-          if [ -z "$DATE" ]; then
-            DATE=$(date +%Y-%m-%d)
-            COMMIT=$(git rev-parse HEAD)
-          fi
-          echo "date=$DATE" >> $GITHUB_OUTPUT
-          echo "commit=$COMMIT" >> $GITHUB_OUTPUT
+          echo "date=$(cat JETLS_VERSION)" >> $GITHUB_OUTPUT
+          echo "commit=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
       - name: Build and deploy
         run: julia --color=yes --project=docs docs/make.jl
         env:
@@ -106,13 +99,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          ref: master
+          ref: ${{ github.event.pull_request.head.ref }}
 
       - name: Extract version
         id: version
         run: |
-          BRANCH="${{ github.event.pull_request.head.ref }}"
-          VERSION="${BRANCH#releases/}"
+          VERSION=$(cat JETLS_VERSION)
           echo "version=$VERSION" >> $GITHUB_OUTPUT
 
       - name: Extract release notes from CHANGELOG
@@ -153,9 +145,8 @@ jobs:
       - name: Extract release info
         id: release_info
         run: |
-          # Extract version from branch name (releases/YYYY-MM-DD)
-          BRANCH="${{ github.event.pull_request.head.ref }}"
-          VERSION="${BRANCH#releases/}"
+          git fetch origin ${{ github.event.pull_request.head.ref }}
+          VERSION=$(git show origin/${{ github.event.pull_request.head.ref }}:JETLS_VERSION)
           echo "version=$VERSION" >> $GITHUB_OUTPUT
 
           # Get the merge commit SHA (short form)

CHANGELOG.md

@@ -14,7 +14,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ## Unreleased
 
 - Commit: [`HEAD`](https://github.com/aviatesk/JETLS.jl/commit/HEAD)
-- Diff: [`6bc34f1...HEAD`](https://github.com/aviatesk/JETLS.jl/compare/6bc34f1...HEAD)
+- Diff: [`6ec51e1...HEAD`](https://github.com/aviatesk/JETLS.jl/compare/6ec51e1...HEAD)
+
+### Removed
+
+- Removed the deprecated `runserver.jl` script. Users should use the `jetls`
+  executable app instead. See the [2025-11-24](#2025-11-24) release notes for
+  migration details.
+
+## 2025-11-27
+
+- Commit: [`6ec51e1`](https://github.com/aviatesk/JETLS.jl/commit/6ec51e1)
+- Diff: [`6bc34f1...6ec51e1`](https://github.com/aviatesk/JETLS.jl/compare/6bc34f1...6ec51e1)
 
 ### Added
 
@@ -27,8 +38,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Changed
 
-- Updated CodeTracking.jl, LoweredCodeUtils and JET.jldependencies to the latest
-  development versions.
+- Updated CodeTracking.jl, LoweredCodeUtils and JET.jl dependencies to the
+  latest development versions.
 
 ### Internal
 

JETLS_VERSION

@@ -1 +1 @@
-2025-11-27
+2025-11-28

Project.toml

@@ -32,24 +32,24 @@ StructTypes = "66bcceda-d870-5865-93dd-65803322e79e"
 TOML = "fa267f1f-6049-4f14-aa54-33bafae1ed76"
 
 [sources]
-CodeTracking = {rev = "releases/2025-11-27", subdir = "vendor/CodeTracking", url = "https://github.com/aviatesk/JETLS.jl"}
-Compiler = {rev = "releases/2025-11-27", subdir = "vendor/Compiler", url = "https://github.com/aviatesk/JETLS.jl"}
-Configurations = {rev = "releases/2025-11-27", subdir = "vendor/Configurations", url = "https://github.com/aviatesk/JETLS.jl"}
-ExproniconLite = {rev = "releases/2025-11-27", subdir = "vendor/ExproniconLite", url = "https://github.com/aviatesk/JETLS.jl"}
-Glob = {rev = "releases/2025-11-27", subdir = "vendor/Glob", url = "https://github.com/aviatesk/JETLS.jl"}
-JET = {rev = "releases/2025-11-27", subdir = "vendor/JET", url = "https://github.com/aviatesk/JETLS.jl"}
-JSON3 = {rev = "releases/2025-11-27", subdir = "vendor/JSON3", url = "https://github.com/aviatesk/JETLS.jl"}
-JuliaInterpreter = {rev = "releases/2025-11-27", subdir = "vendor/JuliaInterpreter", url = "https://github.com/aviatesk/JETLS.jl"}
-JuliaLowering = {rev = "releases/2025-11-27", subdir = "vendor/JuliaLowering", url = "https://github.com/aviatesk/JETLS.jl"}
-JuliaSyntax = {rev = "releases/2025-11-27", subdir = "vendor/JuliaSyntax", url = "https://github.com/aviatesk/JETLS.jl"}
-LSP = {rev = "releases/2025-11-27", subdir = "vendor/LSP", url = "https://github.com/aviatesk/JETLS.jl"}
-LoweredCodeUtils = {rev = "releases/2025-11-27", subdir = "vendor/LoweredCodeUtils", url = "https://github.com/aviatesk/JETLS.jl"}
-MacroTools = {rev = "releases/2025-11-27", subdir = "vendor/MacroTools", url = "https://github.com/aviatesk/JETLS.jl"}
-OrderedCollections = {rev = "releases/2025-11-27", subdir = "vendor/OrderedCollections", url = "https://github.com/aviatesk/JETLS.jl"}
-Parsers = {rev = "releases/2025-11-27", subdir = "vendor/Parsers", url = "https://github.com/aviatesk/JETLS.jl"}
-PrecompileTools = {rev = "releases/2025-11-27", subdir = "vendor/PrecompileTools", url = "https://github.com/aviatesk/JETLS.jl"}
-Preferences = {rev = "releases/2025-11-27", subdir = "vendor/Preferences", url = "https://github.com/aviatesk/JETLS.jl"}
-StructTypes = {rev = "releases/2025-11-27", subdir = "vendor/StructTypes", url = "https://github.com/aviatesk/JETLS.jl"}
+CodeTracking = {rev = "releases/2025-11-28", subdir = "vendor/CodeTracking", url = "https://github.com/aviatesk/JETLS.jl"}
+Compiler = {rev = "releases/2025-11-28", subdir = "vendor/Compiler", url = "https://github.com/aviatesk/JETLS.jl"}
+Configurations = {rev = "releases/2025-11-28", subdir = "vendor/Configurations", url = "https://github.com/aviatesk/JETLS.jl"}
+ExproniconLite = {rev = "releases/2025-11-28", subdir = "vendor/ExproniconLite", url = "https://github.com/aviatesk/JETLS.jl"}
+Glob = {rev = "releases/2025-11-28", subdir = "vendor/Glob", url = "https://github.com/aviatesk/JETLS.jl"}
+JET = {rev = "releases/2025-11-28", subdir = "vendor/JET", url = "https://github.com/aviatesk/JETLS.jl"}
+JSON3 = {rev = "releases/2025-11-28", subdir = "vendor/JSON3", url = "https://github.com/aviatesk/JETLS.jl"}
+JuliaInterpreter = {rev = "releases/2025-11-28", subdir = "vendor/JuliaInterpreter", url = "https://github.com/aviatesk/JETLS.jl"}
+JuliaLowering = {rev = "releases/2025-11-28", subdir = "vendor/JuliaLowering", url = "https://github.com/aviatesk/JETLS.jl"}
+JuliaSyntax = {rev = "releases/2025-11-28", subdir = "vendor/JuliaSyntax", url = "https://github.com/aviatesk/JETLS.jl"}
+LSP = {rev = "releases/2025-11-28", subdir = "vendor/LSP", url = "https://github.com/aviatesk/JETLS.jl"}
+LoweredCodeUtils = {rev = "releases/2025-11-28", subdir = "vendor/LoweredCodeUtils", url = "https://github.com/aviatesk/JETLS.jl"}
+MacroTools = {rev = "releases/2025-11-28", subdir = "vendor/MacroTools", url = "https://github.com/aviatesk/JETLS.jl"}
+OrderedCollections = {rev = "releases/2025-11-28", subdir = "vendor/OrderedCollections", url = "https://github.com/aviatesk/JETLS.jl"}
+Parsers = {rev = "releases/2025-11-28", subdir = "vendor/Parsers", url = "https://github.com/aviatesk/JETLS.jl"}
+PrecompileTools = {rev = "releases/2025-11-28", subdir = "vendor/PrecompileTools", url = "https://github.com/aviatesk/JETLS.jl"}
+Preferences = {rev = "releases/2025-11-28", subdir = "vendor/Preferences", url = "https://github.com/aviatesk/JETLS.jl"}
+StructTypes = {rev = "releases/2025-11-28", subdir = "vendor/StructTypes", url = "https://github.com/aviatesk/JETLS.jl"}
 
 [compat]
 Configurations = "0.17.6"

docs/Project.toml

@@ -1,2 +1,6 @@
 [deps]
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+JETLS = "a3b70258-0602-4ee2-b5a6-54c2470400db"
+
+[sources]
+JETLS = {path = ".."}

docs/make.jl

@@ -1,5 +1,5 @@
 using Documenter
-# using JETLS
+using JETLS
 
 const devbranch = get(ENV, "DOCUMENTER_DEVBRANCH", "master")
 const release_date = get(ENV, "DOCUMENTER_RELEASE_DATE", "")
@@ -24,7 +24,7 @@ if devbranch == "release" && !isempty(release_date)
 end
 
 makedocs(;
-    # modules = [JETLS],
+    modules = [JETLS],
     sitename = "JETLS.jl",
     format = Documenter.HTML(;
         prettyurls = get(ENV, "CI", "false") == "true",
@@ -39,6 +39,7 @@ makedocs(;
         "Configuration" => "configuration.md",
         "Launching" => "launching.md",
     ],
+    warnonly = [:missing_docs]
 )
 
 # Custom deploy configuration for `release` branch deployment

docs/src/launching.md

@@ -16,27 +16,10 @@ You can run `jetls` with various options to configure how the server communicate
 with clients.
 
 > `jetls --help`
-```
-JETLS - A Julia language server with runtime-aware static analysis,
-powered by JET.jl, JuliaSyntax.jl, and JuliaLowering.jl
-
-Usage: jetls [OPTIONS]
-
-Communication channel options (choose one, default: --stdio):
-  --stdio                     Use standard input/output (not recommended)
-  --pipe-connect=<path>       Connect to client's Unix domain socket/named pipe
-  --pipe-listen=<path>        Listen on Unix domain socket/named pipe
-  --socket=<port>             Listen on TCP socket
-
-Options:
-  --clientProcessId=<pid>     Monitor client process (enables crash detection)
-  --help, -h                  Show this help message
-
-Examples:
-  jetls --pipe-listen=/tmp/jetls.sock
-  jetls --pipe-connect=/tmp/jetls.sock --clientProcessId=12345
-  jetls --socket=8080
-  jetls --threads=auto -- --clientProcessId=12345
+```@eval
+using JETLS
+using Markdown
+Markdown.parse('`'^3 * '\n' * JETLS.help_message * '\n' * '`'^3)
 ```
 
 ## Communication channels

prepare-release.sh

@@ -0,0 +1 @@
+scripts/prepare-release.sh