fix(gdscript): address review feedback — configurable port/timeout, safer version detection

- Rename LSP_PORT → DEFAULT_GODOT_LS_PORT and add DEFAULT_GODOT_REQUEST_TIMEOUT
- Make port and request_timeout overridable via ls_specific_settings["gdscript"]
  by reading self._custom_settings in _create_language_server_interface
- Move self._conn_info setup into _create_language_server_interface so it can
  consume ls_specific_settings (which requires super().__init__ to have run)
- Fix _detect_godot_version to return int | None instead of always defaulting to 4:
  use an explicit config_version→major dict; return None for unrecognized versions
  and detection failures; caller logs warning on None
- Update setup guide and configuration reference docs with new settings

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs/02-usage/050_configuration.md

@@ -487,6 +487,27 @@ Supported settings:
 | `fsautocomplete_version` | `0.83.0` | Override the FsAutoComplete version Serena installs as a .NET tool. |
 
 
+#### GDScript (Godot Engine)
+
+Serena connects to the Godot editor's built-in LSP server over TCP. No separate process is launched.
+
+Supported settings:
+
+| Setting | Default | Description |
+|---|---|---|
+| `port` | `6008` | TCP port the running Godot editor listens on for LSP connections. |
+| `request_timeout` | `30.0` | Seconds to wait for a response from the Godot LSP server. |
+
+Example:
+
+```yaml
+ls_specific_settings:
+  gdscript:
+    port: 6008
+    request_timeout: 60.0
+```
+
+
 #### Go (`gopls`)
 
 Serena forwards `ls_specific_settings.go.gopls_settings` to `gopls` as LSP `initializationOptions` when the Go language server is started.

docs/03-special-guides/godot_gdscript_setup_guide_for_serena.md

@@ -19,9 +19,11 @@ When a Godot project is open in the editor, the editor listens for LSP connectio
 
 Serena automatically detects which major version of Godot your project targets by reading the `config_version` field from `project.godot`:
 
-- `config_version` ≥ 5 → Godot 4
+- `config_version` = 5 → Godot 4
 - `config_version` = 4 → Godot 3
 
+If `config_version` is not recognized (e.g. from a future Godot release), Serena logs a warning and still connects — both Godot 3 and Godot 4 use the same port.
+
 No additional configuration is needed for version detection.
 
 ---
@@ -71,6 +73,20 @@ To mitigate this:
 | Editor must stay open | Serena requires the Godot editor to be running throughout the session. Closing the editor breaks the TCP connection; restart Serena after reopening the editor. |
 | Slower workspace operations | `find_symbol` and `find_references` across the whole workspace are slower than for languages whose LSP servers support native workspace-wide queries. |
 
+---
+## Advanced Configuration
+
+You can customize Serena's GDScript connection via `ls_specific_settings` in your `serena_config.yml` or `project.yml`:
+
+```yaml
+ls_specific_settings:
+  gdscript:
+    port: 6008         # TCP port the Godot editor listens on (default: 6008)
+    request_timeout: 30.0  # seconds to wait for an LSP response (default: 30.0)
+```
+
+These override the defaults only if explicitly set.
+
 ---
 ## Reference