From 833f518c3d855acdcbee13ff1678b99cfd8803de Mon Sep 17 00:00:00 2001 From: Michael Panchenko Date: Wed, 13 May 2026 23:34:40 +0200 Subject: [PATCH] Changelog, minor fixes --- CHANGELOG.md | 12 ++++++------ docs/02-usage/045_memories.md | 6 ++++-- pyproject.toml | 2 +- 3 files changed, 11 insertions(+), 9 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index f310bc59..b9f67003 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,16 +13,15 @@ Status of the `main` branch. Changes prior to the next official version change w * Memories: - Memories can now reference each other using the `` `mem:NAME` `` convention. Renames propagate to all references automatically. See the [reference convention](https://oraios.github.io/serena/02-usage/045_memories.html#referencing-memories-from-other-memories). - - New `serena memories` CLI command group: `list`, `read`, `write`, `check` (referential - integrity report) and `auto-prefix-references` (heuristic rewrite of bare occurrences). - See the [CLI subcommands](https://oraios.github.io/serena/02-usage/045_memories.html#cli-subcommands). - Onboarding now seeds a `memory_maintenance` memory describing the memory-style and routing conventions, and the agent is instructed to read it before writing any other memories. A `global/memory_maintenance` memory takes precedence over the per-project seed. See the [memory maintenance section](https://oraios.github.io/serena/02-usage/045_memories.html#the-memory-maintenance-memory). - - Onboarding prompt rewritten to target a layout of `mem:core` (routing entry point), - `mem:suggested_commands`, `mem:tech_stack`, `mem:conventions`, `mem:task_completion`, - and optional per-module `mem:/core` memories, using dense agent-notes style. + +* CLI: + - Add `serena memories` CLI command group: `list`, `read`, `write`, `check` (referential + integrity report) and `auto-prefix-references` (heuristic rewrite of bare occurrences). + See the [CLI subcommands](https://oraios.github.io/serena/02-usage/045_memories.html#cli-subcommands). * Tools: - `edit_memory`: New `dotall` parameter (default `False`) controlling whether ``.`` matches @@ -31,6 +30,7 @@ Status of the `main` branch. Changes prior to the next official version change w avoids accidentally consuming large spans of content. Pass `dotall=True` for multi-line edits. - `search_for_pattern`: New `dotall` parameter (default `True`, preserving existing behavior) exposing the DOTALL flag, and the docstring was tightened. + - Delete `check_onboarding_performed` tool (instead extend project activation message), # v1.3.0 (2026-05-11) diff --git a/docs/02-usage/045_memories.md b/docs/02-usage/045_memories.md index e14d3b31..6c3560a9 100644 --- a/docs/02-usage/045_memories.md +++ b/docs/02-usage/045_memories.md @@ -4,6 +4,7 @@ Serena provides the functionality of a fully featured agent, and a useful aspect Despite its simplicity, we received positive feedback from many users who tend to combine it with their agent's internal memory management (e.g., `AGENTS.md` files). +(memories)= ## Memories Memories are simple, human-readable Markdown files that both you and @@ -45,10 +46,10 @@ criteria: prefix for references to memories, which does not prevent using the memory files outside of Serena. 7. **Configurable and composable.** Two orthogonal memory scopes - - [per-project](#memories) (committed alongside the code) and [global](global-memories) + [per-project](memories) (committed alongside the code) and [global](global-memories) (shared across all your projects) - can be combined freely. Within either scope, regex patterns in the global or project configuration can mark subsets as read-only - or [hide them entirely](#ignoring-memories) from the agent. This lets a project mix + or [hide them entirely](ignoring-memories) from the agent. This lets a project mix personal cross-project knowledge with checked-in project conventions, and selectively freeze either set, without custom plumbing. @@ -103,6 +104,7 @@ Since global memories are not versioned alongside your project files, it can be helpful to track global memories with git (i.e. to make `~/.serena/memories/` a git repository) in order to have a history of changes and the possibility to revert them if needed. +(ignoring-memories)= ### Ignoring Memories Projects that accumulate large numbers of archived memory files can use `ignored_memory_patterns` diff --git a/pyproject.toml b/pyproject.toml index f3e3e76b..e50286b5 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -361,7 +361,7 @@ markers = [ [tool.codespell] # Ref: https://github.com/codespell-project/codespell#using-a-config-file -skip = '.git*,*.svg,*.lock,*.min.*' +skip = '.git*,*.svg,*.lock,*.min.*,*test_memories_manager.py' check-hidden = true ignore-regex = '\.\w+' ignore-words-list = 'paket,EDN,als'