feat(config): add CLI arg parsing and fallback logic

- Add clap-based CLI parser with robust LSP passthrough fallback
- CLI args override config file fields for container, paths, exec, etc.
- Support `--` separator for unambiguous LSP argument forwarding
- Auto-detect executable name from binary for proxy replacement
- Refactor config loading to merge CLI and file sources
- Remove encoded_local_path; use local_path normalization and encoding
- Update Windows path handling and binary name extraction
- Add fallback to local LSP if Docker attach fails
- Update docs and examples for new CLI usage and argument precedence

Author: richardhapb

.github/workflows/release.yml

@@ -82,12 +82,57 @@ jobs:
     if: startsWith(github.ref, 'refs/tags/v')
 
     steps:
+      - name: Checkout repository
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0  # Fetch all history for changelog generation
+      
       - name: Download all build artifacts
         uses: actions/download-artifact@v5
         with:
           path: dist
-
+      
+      - name: Generate release notes
+        id: release_notes
+        run: |
+          # Get the previous tag
+          PREV_TAG=$(git tag --sort=-v:refname | sed -n '2p')
+          CURRENT_TAG=${GITHUB_REF#refs/tags/}
+          
+          # Generate changelog
+          if [ -z "$PREV_TAG" ]; then
+            # First release - use all commits
+            CHANGELOG=$(git log --pretty=format:"- %s (%h)" --no-merges)
+          else
+            # Generate changelog between tags
+            CHANGELOG=$(git log ${PREV_TAG}..${CURRENT_TAG} --pretty=format:"- %s (%h)" --no-merges)
+          fi
+          
+          # Create release notes
+          cat > release_notes.md << EOF
+          ## What's Changed
+          
+          ${CHANGELOG}
+          
+          ## Installation
+          
+          Download the appropriate binary for your platform:
+          - **Linux (x86_64)**: \`lspdock-x86_64-unknown-linux-gnu.tar.gz\`
+          - **Windows (x86_64)**: \`lspdock-x86_64-pc-windows-gnu.zip\`
+          - **macOS (Apple Silicon)**: \`lspdock-aarch64-apple-darwin.tar.gz\`
+          
+          Extract and place the binary in your PATH.
+          
+          **Full Changelog**: https://github.com/${{ github.repository }}/compare/${PREV_TAG}...${CURRENT_TAG}
+          EOF
+          
+          echo "Generated release notes"
+      
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
           files: dist/**/*
+          body_path: release_notes.md
+          draft: false
+          prerelease: false
+          generate_release_notes: false

.github/workflows/test.yml

@@ -53,23 +53,10 @@ jobs:
         with:
           targets: ${{ matrix.platform.target }}
 
-      - name: Cache cargo registry
-        uses: actions/cache@v4
+      - name: Setup Rust cache
+        uses: Swatinem/rust-cache@v2
         with:
-          path: ~/.cargo/registry
-          key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}
-
-      - name: Cache cargo index
-        uses: actions/cache@v4
-        with:
-          path: ~/.cargo/git
-          key: ${{ runner.os }}-cargo-index-${{ hashFiles('**/Cargo.lock') }}
-
-      - name: Cache cargo build
-        uses: actions/cache@v4
-        with:
-          path: target
-          key: ${{ runner.os }}-cargo-build-target-${{ hashFiles('**/Cargo.lock') }}
+          key: ${{ matrix.platform.target }}
 
       - name: Install cross
         if: matrix.platform.use_cross

Cargo.lock

@@ -1,9 +1,10 @@
 [package]
 name = "lspdock"
-version = "0.1.8"
+version = "0.2.0"
 edition = "2024"
 
 [dependencies]
+clap = { version = "4.5.53", features = ["derive"] }
 dirs = "6.0.0"
 futures-core = "0.3.31"
 memchr = "2.7.6"