Skip to content

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

Rust

docs(retention): align decay terminology (#391)

AkitaOnRails232cecc8f571
diff --git a/crates/ai-memory-cli/src/config.rs b/crates/ai-memory-cli/src/config.rs
index 4424e635..e12eef46 100644
--- a/crates/ai-memory-cli/src/config.rs
+++ b/crates/ai-memory-cli/src/config.rs
@@ -55,7 +55,7 @@ pub struct DecaySettings {
pub mu: f64,
/// Default page salience.
pub salience_default: f64,
- /// Soft-delete threshold.
+ /// Wiki-backed eviction threshold.
pub cold_threshold: f64,
/// Grace period before permanently deleting an evicted version chain.
pub hard_delete_after_days: i64,
diff --git a/crates/ai-memory-consolidate/tests/lifecycle.rs b/crates/ai-memory-consolidate/tests/lifecycle.rs
index 65e16a22..5fb65163 100644
--- a/crates/ai-memory-consolidate/tests/lifecycle.rs
+++ b/crates/ai-memory-consolidate/tests/lifecycle.rs
@@ -317,7 +317,7 @@ async fn m8_retention_lifecycle_end_to_end() {
assert_eq!(
counts_after.pages_all as usize,
FIXTURES.len(),
- "soft-delete preserves the row (kept for 180d hard-delete window)",
+ "eviction preserves a tombstone for the hard-delete grace period",
);
let project_root = wiki.project_root(ws, proj);
for fixture in FIXTURES {
diff --git a/crates/ai-memory-store/src/decay.rs b/crates/ai-memory-store/src/decay.rs
index 40d41fa1..35ce5d44 100644
--- a/crates/ai-memory-store/src/decay.rs
+++ b/crates/ai-memory-store/src/decay.rs
@@ -25,7 +25,7 @@ pub struct DecayParams {
pub mu: f64,
/// Default salience used when a page doesn't have an explicit one.
pub salience_default: f64,
- /// Below this score, an episodic page is a soft-delete candidate.
+ /// Below this score, an episodic page is an eviction candidate.
pub cold_threshold: f64,
/// Days an evicted page's tombstone and version ancestry survive before
/// permanent deletion.
diff --git a/crates/ai-memory-store/src/writer.rs b/crates/ai-memory-store/src/writer.rs
index 894a1f8b..6f2b1f26 100644
--- a/crates/ai-memory-store/src/writer.rs
+++ b/crates/ai-memory-store/src/writer.rs
@@ -979,7 +979,7 @@ impl WriterHandle {
rx.await.map_err(|_| StoreError::WriterClosed)?
}
- /// Soft-delete the expected latest page identified by the forget sweep.
+ /// Tombstone the expected latest page identified by the forget sweep.
///
/// # Errors
/// Returns [`StoreError::WriterClosed`] or propagates SQL errors.
diff --git a/crates/ai-memory-wiki/src/wiki.rs b/crates/ai-memory-wiki/src/wiki.rs
index 11f21286..a0455afc 100644
--- a/crates/ai-memory-wiki/src/wiki.rs
+++ b/crates/ai-memory-wiki/src/wiki.rs
@@ -543,8 +543,8 @@ impl Wiki {
.await
}
- /// Remove the authoritative file and soft-delete the expected latest page
- /// as a decay tombstone. A stale candidate leaves both disk and store
+ /// Remove the authoritative file and tombstone the expected latest page.
+ /// A stale candidate leaves both disk and store
/// untouched.
///
/// # Errors