From 9f4e29c8b0d53e6fcc43633d49f4e72bcf37d1d2 Mon Sep 17 00:00:00 2001 From: Michael Panchenko Date: Tue, 5 May 2026 17:31:15 +0200 Subject: [PATCH] Changelog, readme, project.yml - minor changes --- .serena/project.yml | 22 ++++++++++++++++------ CHANGELOG.md | 4 ++-- README.md | 7 +++++-- 3 files changed, 23 insertions(+), 10 deletions(-) diff --git a/.serena/project.yml b/.serena/project.yml index aa5d12e3..c49f5a03 100644 --- a/.serena/project.yml +++ b/.serena/project.yml @@ -87,12 +87,13 @@ encoding: utf-8 # Set this to a list of mode names to always include the respective modes for this project. base_modes: -# list of mode names that are to be activated by default. +# list of mode names that are to be activated by default, overriding the setting in the global configuration. # The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes. -# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply. +# If the setting is undefined/empty, the default_modes from the global configuration (serena_config.yml) apply. # Otherwise, this overrides the setting from the global configuration (serena_config.yml). +# Therefore, you can set this to [] if you do not want the default modes defined in the global config to apply +# for this project. # This setting can, in turn, be overridden by CLI parameters (--mode). -# Set this to [] to not use the default modes defined in the global config for this project. # See https://oraios.github.io/serena/02-usage/050_configuration.html#modes default_modes: @@ -137,9 +138,18 @@ ignored_memory_patterns: [] # No documentation on options means no options are available. ls_specific_settings: {} -# list of mode names to be activated additionally for this project. +# list of mode names to be activated additionally for this project, e.g. ["query-projects"] # The full set of modes to be activated is base_modes (from global config) + default_modes + added_modes. -# Otherwise, this setting overrides the global configuration. -# Set this to a list of mode names to always include the respective modes for this project. # 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). +# 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. +# Currently supported for: TypeScript. +# Example: +# additional_workspace_folders: +# - ../sibling-package +# - ../shared-lib +additional_workspace_folders: [] diff --git a/CHANGELOG.md b/CHANGELOG.md index d5d71bc5..8e76ce72 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,14 +7,14 @@ Status of the `main` branch. Changes prior to the next official version change w Instead, they can define `added_modes` to add modes on top of base and default modes. See updated [documentation on modes](https://oraios.github.io/serena/02-usage/050_configuration.html#modes). - Serena's default configuration now uses `interactive` and `editing` as `base_modes` instead of as `default_modes`. - - Add cross-package reference support via `additional_workspace_folders` setting (currently implemented for TypeScript). * JetBrains: - Add new tools: - `jet_brains_list_inspections`: Lists available IDE inspections (akin to diagnostics), optionally filtered by language or group - `jet_brains_run_inspections`: Runs IDE inspections on a file and returns the results -* LSP Tools: +* LSP Backend: + - Add cross-package reference support via `additional_workspace_folders` setting (currently implemented for TypeScript). - Add new tools: - `find_declaration`: Finds the declaration/definition of a symbol - `find_implementations`: Finds the implementations of an interface or abstract method diff --git a/README.md b/README.md index b0909f06..3bd53899 100644 --- a/README.md +++ b/README.md @@ -145,11 +145,14 @@ without reading entire files. | find referencing symbols | yes | yes | | search in project dependencies | -- | yes | | type hierarchy | -- | yes | -| find declaration | yes | yes | -| find implementations | yes | yes | +| find declaration | yes* | yes | +| find implementations | yes** | yes | | query external projects | yes | yes | | diagnostics/inspections | yes | yes | +*: Will generally not work for declarations in external dependencies.
+**: Only available for some languages, limited by the language server functionality. + ### Refactoring Without precise refactoring tools, agents are forced to resort to unreliable and expensive search and replace operations.