⬆️ Update Serena to 1.6.1 in agentic devenv (#10770)

Update project files accordingly

.serena/project.yml

@@ -1,26 +1,31 @@
-# the name by which the project can be referenced within Serena
+# the name by which the project can be referenced within Serena/when chatting with the LLM.
 project_name: "penpot"
 
-
+# list of languages for which language servers are started (LSP backend only); choose from:
-# list of languages for which language servers are started; choose from:
+#   ada                 al                  angular             ansible             bash
-#   al                  ansible             bash                clojure             cpp
+#   bsl                 clojure             cpp                 cpp_ccls            crystal
-#   cpp_ccls            crystal             csharp              csharp_omnisharp    dart
+#   csharp              csharp_omnisharp    cue                 dart                elixir
-#   elixir              elm                 erlang              fortran             fsharp
+#   elm                 erlang              fortran             fsharp              gdscript
 #   go                  groovy              haskell             haxe                hlsl
-#   java                json                julia               kotlin              lean4
+#   html                java                json                julia               kotlin
-#   lua                 luau                markdown            matlab              msl
+#   latex               lean4               lua                 luau                markdown
-#   nix                 ocaml               pascal              perl                php
+#   matlab              msl                 nix                 ocaml               pascal
-#   php_phpactor        powershell          python              python_jedi         python_ty
+#   perl                php                 php_phpactor        php_phpantom        powershell
-#   r                   rego                ruby                ruby_solargraph     rust
+#   python              python_jedi         python_pyrefly      python_ty           r
-#   scala               solidity            swift               systemverilog       terraform
+#   rego                ruby                ruby_solargraph     rust                scala
-#   toml                typescript          typescript_vts      vue                 yaml
+#   scss                solidity            svelte              swift               systemverilog
-#   zig
+#   terraform           toml                typescript          typescript_vts      vue
-#   (This list may be outdated. For the current list, see values of Language enum here:
+#   yaml                zig
-#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   (This list may be outdated; generated with scripts/print_language_list.py;
-#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+#   For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py)
+# For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
 # Note:
 #   - For C, use cpp
 #   - For JavaScript, use typescript
+#   - For Angular projects, use angular (subsumes typescript+html; requires `npm install` in the project root)
+#   - For Svelte projects, use svelte (subsumes typescript/javascript for .svelte projects; requires npm)
+#   - For SCSS / Sass / plain CSS, use scss (some-sass-language-server handles all three)
 #   - For Free Pascal/Lazarus, use pascal
 # Special requirements:
 #   Some languages require additional setup/installations.
@@ -54,12 +59,19 @@ ignore_all_files_in_gitignore: true
 
 # advanced configuration option allowing to configure language server-specific options.
 # Maps the language key to the options.
-# Have a look at the docstring of the constructors of the LS implementations within solidlsp (e.g., for C# or PHP) to see which options are available.
+# The settings are considered only if the project is trusted (see global configuration to define trusted projects).
-# No documentation on options means no options are available.
+# See https://oraios.github.io/serena/02-usage/050_configuration.html#language-server-specific-settings
 ls_specific_settings: {}
 
 # list of additional paths to ignore in this project.
 # Same syntax as gitignore, so you can use * and **.
+# Important: quote patterns that start with `*`, otherwise YAML treats them as aliases.
+# Example:
+#   ignored_paths:
+#     - "examples/**"
+#     - ".worktrees/**"
+#     - "**/bin/**"
+#     - "**/obj/**"
 # Note: global ignored_paths from serena_config.yml are also applied additively.
 ignored_paths: []
 
@@ -130,13 +142,38 @@ ignored_memory_patterns: []
 # See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
 added_modes:
 
-# list of additional workspace folder paths for cross-package reference support (e.g. in monorepos).
+# list of additional workspace folder paths for cross-package reference support.
 # Paths can be absolute or relative to the project root.
 # Each folder is registered as an LSP workspace folder, enabling language servers to discover
-# symbols and references across package boundaries.
+# symbols and references across package boundaries, but these folders are not indexed by Serena,
-# Currently supported for: TypeScript.
+# i.e. the respective symbols will not be found using Serena's symbol search tools.
 # Example:
 #   additional_workspace_folders:
 #     - ../sibling-package
 #     - ../shared-lib
-additional_workspace_folders: []
+ls_additional_workspace_folders: []
+
+# list of workspace folder paths (LSP backend only).
+# These folders will be used to build up Serena's symbol index.
+# Paths must be within the project root and should thus be relative to the project root.
+# Furthermore, the paths should not be filtered by ignore settings.
+# Default setting: The entire project root folder (".") is considered.
+# In (large) monorepos, this can be used to index only subfolders of the project root, e.g.
+#   ls_workspace_folders:
+#     - "./subproject1"
+#     - "./subproject2"
+ls_workspace_folders:
+- .
+
+# optional shell command to run before the language backend (LSP or JetBrains) is initialised.
+# the command runs in the project root directory and is only executed if the project is trusted
+# (see trusted_project_path_patterns in the global configuration).
+# serena waits for the command to exit: a non-zero exit code is logged as an error but does not
+# abort activation. a per-project timeout (activation_command_timeout, default 180s) is the safety
+# backstop for non-terminating commands; on expiry the process is killed and activation continues.
+# example: activation_command: "npx nx run-many -t build"
+activation_command:
+
+# maximum time in seconds to wait for activation_command to complete before killing it (default 180s).
+# must be a positive number.
+activation_command_timeout: 180.0

docker/devenv/Dockerfile

@@ -217,7 +217,7 @@ ENV CLJKONDO_VERSION=2026.05.25 \
     UV_TOOL_DIR=/opt/uv/tools \
     UV_TOOL_BIN_DIR=/opt/utils/bin \
     UV_PYTHON_INSTALL_DIR=/opt/uv/python \
-    SERENA_VERSION=1.5.0
+    SERENA_VERSION=1.6.1
 
 RUN set -ex; \
     ARCH="$(dpkg --print-architecture)"; \

docker/devenv/docker-compose.main.yml

@@ -89,9 +89,9 @@ services:
       - PENPOT_TENANT=${PENPOT_TENANT}
       - PENPOT_TMUX_ATTACH=${PENPOT_TMUX_ATTACH}
 
-      # Agentic devenv: set to a commit/tag to update Serena on startup,
+      # Agentic devenv: set to a PyPI release version/tag to update Serena on startup,
       # leave empty to skip update and use the version baked into the image.
-      - SERENA_UPDATE_VERSION=1.5.0
+      - SERENA_UPDATE_VERSION=1.6.1
       - SHADOW_SERVER_URL=${SHADOW_SERVER_URL}
 
     networks:

mcp/.serena/project.yml

@@ -4,6 +4,13 @@ ignore_all_files_in_gitignore: true
 
 # list of additional paths to ignore in this project.
 # Same syntax as gitignore, so you can use * and **.
+# Important: quote patterns that start with `*`, otherwise YAML treats them as aliases.
+# Example:
+#   ignored_paths:
+#     - "examples/**"
+#     - ".worktrees/**"
+#     - "**/bin/**"
+#     - "**/obj/**"
 # Note: global ignored_paths from serena_config.yml are also applied additively.
 ignored_paths: []
 
@@ -21,7 +28,7 @@ excluded_tools: []
 # (contrary to the memories, which are loaded on demand).
 initial_prompt: |
   CRITICAL: Always read the "project_overview" memory.
-# the name by which the project can be referenced within Serena
+# the name by which the project can be referenced within Serena/when chatting with the LLM.
 project_name: "penpot-mcp"
 
 # list of mode names to that are always to be included in the set of active modes
@@ -56,23 +63,25 @@ fixed_tools: []
 # For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
 encoding: utf-8
 
-
+# list of languages for which language servers are started (LSP backend only); choose from:
-# list of languages for which language servers are started; choose from:
+#   ada                 al                  angular             ansible             bash
-#   al                  angular             ansible             bash                clojure
+#   bsl                 clojure             cpp                 cpp_ccls            crystal
-#   cpp                 cpp_ccls            crystal             csharp              csharp_omnisharp
+#   csharp              csharp_omnisharp    cue                 dart                elixir
-#   dart                elixir              elm                 erlang              fortran
+#   elm                 erlang              fortran             fsharp              gdscript
-#   fsharp              go                  groovy              haskell             haxe
+#   go                  groovy              haskell             haxe                hlsl
-#   hlsl                html                java                json                julia
+#   html                java                json                julia               kotlin
-#   kotlin              lean4               lua                 luau                markdown
+#   latex               lean4               lua                 luau                markdown
 #   matlab              msl                 nix                 ocaml               pascal
-#   perl                php                 php_phpactor        powershell          python
+#   perl                php                 php_phpactor        php_phpantom        powershell
-#   python_jedi         python_ty           r                   rego                ruby
+#   python              python_jedi         python_pyrefly      python_ty           r
-#   ruby_solargraph     rust                scala               scss                solidity
+#   rego                ruby                ruby_solargraph     rust                scala
-#   svelte              swift               systemverilog       terraform           toml
+#   scss                solidity            svelte              swift               systemverilog
-#   typescript          typescript_vts      vue                 yaml                zig
+#   terraform           toml                typescript          typescript_vts      vue
-#   (This list may be outdated. For the current list, see values of Language enum here:
+#   yaml                zig
-#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   (This list may be outdated; generated with scripts/print_language_list.py;
-#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+#   For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py)
+# For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
 # Note:
 #   - For C, use cpp
 #   - For JavaScript, use typescript
@@ -121,8 +130,8 @@ ignored_memory_patterns: []
 
 # advanced configuration option allowing to configure language server-specific options.
 # Maps the language key to the options.
-# Have a look at the docstring of the constructors of the LS implementations within solidlsp (e.g., for C# or PHP) to see which options are available.
+# The settings are considered only if the project is trusted (see global configuration to define trusted projects).
-# No documentation on options means no options are available.
+# See https://oraios.github.io/serena/02-usage/050_configuration.html#language-server-specific-settings
 ls_specific_settings: {}
 
 # list of mode names to be activated additionally for this project, e.g. ["query-projects"]
@@ -130,13 +139,38 @@ ls_specific_settings: {}
 # See https://oraios.github.io/serena/02-usage/050_configuration.html#modes
 added_modes:
 
-# list of additional workspace folder paths for cross-package reference support (e.g. in monorepos).
+# list of additional workspace folder paths for cross-package reference support.
 # Paths can be absolute or relative to the project root.
 # Each folder is registered as an LSP workspace folder, enabling language servers to discover
-# symbols and references across package boundaries.
+# symbols and references across package boundaries, but these folders are not indexed by Serena,
-# Currently supported for: TypeScript.
+# i.e. the respective symbols will not be found using Serena's symbol search tools.
 # Example:
 #   additional_workspace_folders:
 #     - ../sibling-package
 #     - ../shared-lib
-additional_workspace_folders: []
+ls_additional_workspace_folders: []
+
+# list of workspace folder paths (LSP backend only).
+# These folders will be used to build up Serena's symbol index.
+# Paths must be within the project root and should thus be relative to the project root.
+# Furthermore, the paths should not be filtered by ignore settings.
+# Default setting: The entire project root folder (".") is considered.
+# In (large) monorepos, this can be used to index only subfolders of the project root, e.g.
+#   ls_workspace_folders:
+#     - "./subproject1"
+#     - "./subproject2"
+ls_workspace_folders:
+- .
+
+# optional shell command to run before the language backend (LSP or JetBrains) is initialised.
+# the command runs in the project root directory and is only executed if the project is trusted
+# (see trusted_project_path_patterns in the global configuration).
+# serena waits for the command to exit: a non-zero exit code is logged as an error but does not
+# abort activation. a per-project timeout (activation_command_timeout, default 180s) is the safety
+# backstop for non-terminating commands; on expiry the process is killed and activation continues.
+# example: activation_command: "npx nx run-many -t build"
+activation_command:
+
+# maximum time in seconds to wait for activation_command to complete before killing it (default 180s).
+# must be a positive number.
+activation_command_timeout: 180.0