Add more information to Claude

Author: rockbruno

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-sourcekit-bazel-bsp is a Build Server Protocol (BSP) implementation that bridges sourcekit-lsp (Swift's official Language Server Protocol) with Bazel-based iOS projects. It enables iOS development in alternative IDEs like Cursor and VSCode by providing language server features without requiring Xcode IDE.
+sourcekit-bazel-bsp is a Build Server Protocol (BSP) implementation that bridges sourcekit-lsp (Swift's official Language Server Protocol) with Bazel-based iOS projects. It enables iOS development in alternative IDEs like Cursor and VSCode by providing language server features without requiring the Xcode IDE.
 
 The project itself is built using Swift Package Manager. There is also a `Example/` folder containing a Bazel iOS application demonstrating the tool's functionality.
 
@@ -14,6 +14,8 @@ The project itself is built using Swift Package Manager. There is also a `Exampl
 - **Build the project**: `swift build`
 - **Debug build**: `swift build`
 - **Release build**: `swift build -c release`
+- **Lint**: `swift format lint Sources/ Tests/ Example/ --recursive`
+- **Format**: `swift format Sources/ Tests/ Example/ --recursive --in-place`
 - **Run tests**: `swift test`
 
 ### For the example project
@@ -24,27 +26,26 @@ The project itself is built using Swift Package Manager. There is also a `Exampl
 
 ### Core Components
 
-1. **BSP Server** (`BSPServer.swift`)
-   - Main server implementation using JSONRPCConnection
-   - Handles client lifecycle and message routing
+1. **BSP Server** (`Sources/SourceKitBazelBSP/Server/SourceKitBazelBSPServer.swift`)
+   - Main server implementation using LSPConnection
+   - Handles client lifecycle and message routing + registration
+   - Server configuration managed by `BaseServerConfig.swift` and `InitializedServerConfig.swift`
 
-2. **Message Handler** (`BSPServerMessageHandler.swift`)
-   - Protocol defining BSP request/notification handling
-   - Routes incoming requests to appropriate handlers
+2. **Message Handlers** (`Sources/SourceKitBazelBSP/Server/MessageHandler/`)
+   - `BSPMessageHandler.swift` - Main (dynamic, registration-based) message dispatcher
 
-3. **Request Handlers** (`Requests/`)
-   - `InitializeRequestHandler.swift` - BSP initialization
-   - `WorkspaceBuildTargetsHandler.swift` - Target discovery
-   - `BuildTargetSourcesHandler.swift` - Source file resolution
-   - `TextDocumentSourceKitOptionsHandler.swift` - SourceKit configuration
-   - `PrepareTargetHandler.swift` - Build preparation
+3. **Request Handlers** (`Sources/SourceKitBazelBSP/RequestHandlers/`)
+   - Various handlers that are dynamically registered to the main BSPMessageHandler by the server.
 
-4. **Command Structure** (`Commands/`)
-   - Uses Swift ArgumentParser for CLI interface
-   - Main entry point in `SourcekitBazelBsp.swift`
+4. **Entry Point** (`Sources/sourcekit-bazel-bsp/`)
+   - CLI-related code and argument parsing.
 
-When making changes to the BSP handling code, you should always first inspect how SourceKit-LSP handles will handle the request on their end. The source code for SourceKit-LSP should be available locally inside the `.build` folder after building the tool for the first time.
+5. **Proto Bindings** (`Sources/BazelProtobufBindings/`)
+   - Protobuf bindings to allow type-safe querying with Bazel.
+
+When making changes to the message handlers, you should always first inspect how SourceKit-LSP handles will handle the request on their end. The source code for SourceKit-LSP should be available locally inside the `.build` folder after building the tool for the first time.
 
 ### Key Dependencies
 - **sourcekit-lsp**: Provides BuildServerProtocol and LSPBindings. Receives BSP requests and forwards to this server
 - **Bazel, rules_swift, rules_apple, and apple_support**: Common Bazel-related support for Apple projects, for the example project
+- **swift-protobuf**: For generating the Bazel bindings.