Rust LSP & Toolchain Setup

Set up rust-analyzer LSP integration and install all cargo tools required by the hooks in this project.

Instructions

Execute the following setup steps in order:

1. Verify Rust Toolchain

Check that rustup and cargo are installed:

rustup --version && cargo --version

If not installed, guide the user to https://rustup.rs/

2. Install rust-analyzer

Check if rust-analyzer is available:

which rust-analyzer || rustup component add rust-analyzer

3. Install Nightly Toolchain (required for some tools)

rustup toolchain install nightly

4. Install Required Cargo Tools

Install all tools used by the hooks in hooks/hooks.json:

# Core tools (required)
cargo install cargo-audit       # Security vulnerability scanning
cargo install cargo-deny        # License and security policy enforcement
cargo install cargo-outdated    # Dependency freshness check

# Enhanced analysis (recommended)
cargo install cargo-machete     # Unused dependency detection (fast)
cargo install cargo-semver-checks  # API compatibility verification
cargo install cargo-geiger      # Unsafe code metrics

# Development aids (optional)
cargo install cargo-expand      # Macro expansion viewer
cargo install cargo-bloat       # Binary size analysis
cargo install cargo-mutants     # Mutation testing

# Nightly-only tools
cargo +nightly install cargo-udeps  # Unused dependencies (comprehensive)

5. Verify LSP Configuration

Check that .lsp.json exists and is properly configured:

cat .lsp.json

Expected configuration:

{
    "rust": {
        "command": "rust-analyzer",
        "args": [],
        "extensionToLanguage": {
            ".rs": "rust"
        },
        "transport": "stdio"
    }
}

6. Initialize deny.toml (if using cargo-deny)

If this project uses cargo deny, ensure deny.toml exists:

[ -f deny.toml ] || cargo deny init

7. Verify Hooks Configuration

Confirm hooks are loaded:

cat hooks/hooks.json | head -50

Tool Summary

Tool	Purpose	Hook
rust-analyzer	LSP server for IDE features	Core
cargo-audit	CVE vulnerability scanning	rust-audit
cargo-deny	License/security policy	rust-deny-check
cargo-outdated	Outdated deps	rust-outdated
cargo-machete	Unused deps (fast)	rust-machete
cargo-udeps	Unused deps (thorough)	rust-unused-deps
cargo-semver-checks	API compat	rust-semver-check
cargo-geiger	Unsafe metrics	rust-geiger
cargo-expand	Macro viewer	rust-expand-hint
cargo-bloat	Size analysis	rust-bloat-hint
cargo-mutants	Mutation testing	rust-mutants-hint

Troubleshooting

rust-analyzer not starting

• Ensure Cargo.toml exists in project root
• Run cargo check to generate build artifacts
• Check rust-analyzer logs: rust-analyzer --version

cargo-udeps fails

• Requires nightly: cargo +nightly udeps
• May need: rustup component add rust-src --toolchain nightly

cargo-deny errors

• Initialize config: cargo deny init
• Update advisories: cargo deny fetch

Hooks not running

• Verify Claude Code hooks are enabled in settings
• Check hook matcher patterns match your file structure

Quick Install (All Tools)

One-liner to install everything:

rustup component add rust-analyzer && \
rustup toolchain install nightly && \
cargo install cargo-audit cargo-deny cargo-outdated cargo-machete \
              cargo-semver-checks cargo-geiger cargo-expand cargo-bloat \
              cargo-mutants && \
cargo +nightly install cargo-udeps

After running this command, provide a status summary showing which tools were installed successfully and any that failed.