Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

docs(profile): say that rebuild never removes an entry

Felipe Neves Ricardo04a908585782
diff --git a/CHANGELOG.md b/CHANGELOG.md
index d3639798..500cede1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
+### Fixed
+- Corrected the `profile rebuild` guidance in `docs/cross-project-profile.md`
+ and the command's help: it never removes an entry, and a candidate recorded
+ by an earlier version keeps the classification it was recorded with, so
+ entries 2.6.0 admitted under the looser rules survive the upgrade and a
+ rebuild. The doc now gives the upgrade path, `profile review` then
+ `profile forget` on each entry to drop. (#1155)
+
## [2.6.1] - 2026-10-08
### Fixed
diff --git a/crates/ai-memory-cli/src/cli.rs b/crates/ai-memory-cli/src/cli.rs
index 75a72da7..326a7d0f 100644
--- a/crates/ai-memory-cli/src/cli.rs
+++ b/crates/ai-memory-cli/src/cli.rs
@@ -959,6 +959,10 @@ pub enum ProfileCommand {
Review(ProfileScopeArgs),
/// Re-read every contributing project from the start and rebuild the
/// profile from what it finds (safe to repeat).
+ ///
+ /// It adds and updates entries and never removes one, including an entry
+ /// an earlier version admitted under rules it no longer applies: remove
+ /// those with `profile forget`.
Rebuild,
/// Write the profile entries that fit this repository into a managed
/// block of its rules file, turning your usual choices into hard rules
diff --git a/docs/cross-project-profile.md b/docs/cross-project-profile.md
index c0a76940..b8a40151 100644
--- a/docs/cross-project-profile.md
+++ b/docs/cross-project-profile.md
@@ -112,7 +112,7 @@ ai-memory profile list # every entry with its scope tags
ai-memory profile show tools/pnpm.md # one entry
ai-memory profile forget tools/pnpm.md # remove one entry (stays removed until you say it again)
ai-memory profile review # entries with their evidence, habits still short of the bar
-ai-memory profile rebuild # re-read every project from the start (safe to repeat)
+ai-memory profile rebuild # re-read every project from the start (safe to repeat; removes nothing)
ai-memory profile apply # write the entries that fit this repo into its rules file
ai-memory profile list --user alice # an operator's private profile (share = "user")
ai-memory profile list --workspace work # a workspace profile (share = "workspace")
@@ -245,7 +245,14 @@ the same way, with the word lists and the newest statement.
rewrites a page it did not write, or one whose body changed since it wrote
it, and `profile review` lists it as edited by hand.
- **Start over:** `ai-memory profile rebuild` re-reads every project from the
- beginning. It does not touch entries you edited or removed.
+ beginning. It does not touch entries you edited or removed, and it never
+ removes an entry: a candidate already recorded keeps the classification it
+ was recorded with, and an entry whose evidence no longer meets the bar stays
+ as written.
+- **After upgrading:** a release that tightens what the profile learns applies
+ to sentences read from then on. Entries an earlier version admitted stay,
+ even after `profile rebuild`; list them with `ai-memory profile review` and
+ remove the ones you do not want with `ai-memory profile forget <path>`.
## Server settings