Skip to content

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

Rust

feat(store): page evidence substrate — V63 page_evidence + evidence_count (P2)

AkitaOnRailsc3f686a70efe
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e2e8ee90..8164f67e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -89,6 +89,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
`SessionStart` event is not specified, so capture and managed workstreams
are not claimed. Skills need no extra step — Muse reads `~/.agents/skills`,
which `install-skills` already writes (#659).
+- Belief-strength evidence substrate (P2, `docs/design-hindsight-borrowings.md`
+ §3): a new append-only `page_evidence` table (V63,
+ `(page_id, source_kind, source_id, created_at)`, `source_kind` one of
+ `session`/`observation`/`feedback`/`reconsolidation`) records what
+ produced or reaffirmed each page version, written in the same
+ transaction as the page upsert. Rule-based and zero-LLM — the
+ consolidator cites the session(s) it drew on for both the single-page
+ and batch write paths, so the substrate populates on the default path
+ with no provider configured. `hybrid_search_explained` (and therefore
+ `memory_query(explain=true)`) now reports `evidence_count` per hit,
+ batch-fetched once after fusion; the default (non-explained) path and
+ ranking are unchanged — evidence is inert data and an explain field
+ this release, not a ranking input. The confidence-into-`PageAuthority`
+ step described in the design doc is deferred behind the planned R2
+ retrieval eval.
### Changed
- The privacy sanitizer now redacts to a **typed marker** — `[REDACTED:<kind>]`
diff --git a/crates/ai-memory-cli/src/commands/reindex.rs b/crates/ai-memory-cli/src/commands/reindex.rs
index 973e59cf..e4aaa87d 100644
--- a/crates/ai-memory-cli/src/commands/reindex.rs
+++ b/crates/ai-memory-cli/src/commands/reindex.rs
@@ -122,6 +122,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-cli/src/commands/serve.rs b/crates/ai-memory-cli/src/commands/serve.rs
index 99f29d49..c86ad0ea 100644
--- a/crates/ai-memory-cli/src/commands/serve.rs
+++ b/crates/ai-memory-cli/src/commands/serve.rs
@@ -3486,6 +3486,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -4072,6 +4073,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-consolidate/src/auto_improve_schedule.rs b/crates/ai-memory-consolidate/src/auto_improve_schedule.rs
index 5f21e072..2ca284c7 100644
--- a/crates/ai-memory-consolidate/src/auto_improve_schedule.rs
+++ b/crates/ai-memory-consolidate/src/auto_improve_schedule.rs
@@ -810,6 +810,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-consolidate/src/bootstrap.rs b/crates/ai-memory-consolidate/src/bootstrap.rs
index 49e90ac5..6383c9d8 100644
--- a/crates/ai-memory-consolidate/src/bootstrap.rs
+++ b/crates/ai-memory-consolidate/src/bootstrap.rs
@@ -579,6 +579,7 @@ impl Bootstrap {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
});
}
// Plus the manifest itself.
@@ -609,6 +610,7 @@ impl Bootstrap {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
});
let _ids = self.wiki.apply_batch(requests).await?;
diff --git a/crates/ai-memory-consolidate/src/consolidator.rs b/crates/ai-memory-consolidate/src/consolidator.rs
index 1559e413..85f621b7 100644
--- a/crates/ai-memory-consolidate/src/consolidator.rs
+++ b/crates/ai-memory-consolidate/src/consolidator.rs
@@ -213,6 +213,10 @@ impl Consolidator {
}),
author_id,
actor,
+ evidence: vec![ai_memory_core::PageEvidence {
+ kind: ai_memory_core::PageEvidenceKind::Session,
+ source_id: session_id.to_string(),
+ }],
})
.await?;
// Auto-commit the result so the supersession lands in git.
@@ -497,6 +501,10 @@ impl Consolidator {
if req.path == anchor {
stamp_session_origin(&mut req.frontmatter, session_id, agent_kind);
}
+ req.evidence = vec![ai_memory_core::PageEvidence {
+ kind: ai_memory_core::PageEvidenceKind::Session,
+ source_id: session_id.to_string(),
+ }];
// A slot the engine writes belongs to the operator whose session
// produced it, and `build_update` keeps the model's path verbatim
// for every non-Rule kind — so the path here is attacker-reachable
@@ -699,6 +707,7 @@ fn build_update(
}),
author_id,
actor: actor.clone(),
+ evidence: Vec::new(),
};
let outcome = ConsolidationOutcome {
path,
@@ -1907,6 +1916,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -2418,6 +2428,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -2510,6 +2521,50 @@ mod tests {
}
}
+ /// P2 (docs/design-hindsight-borrowings.md §3): the single-page
+ /// consolidation write cites the session it consolidated as evidence,
+ /// in the same transaction as the page upsert — purely rule-based, no
+ /// LLM involvement in the citation itself.
+ #[tokio::test]
+ async fn single_page_consolidation_records_session_evidence() {
+ let tmp = tempfile::tempdir().unwrap();
+ let (store, wiki, session, ws, proj) = batch_fixture(tmp.path()).await;
+ let response = serde_json::json!({
+ "title": "Queue decision",
+ "body_markdown": "The queue is bounded.",
+ "tags": [],
+ });
+
+ let outcome = Consolidator::new(
+ store.reader.clone(),
+ store.writer.clone(),
+ wiki.clone(),
+ Arc::new(ScriptedLlm(response)),
+ ws,
+ proj,
+ )
+ .consolidate_session(
+ session,
+ false,
+ ai_memory_core::ActorContext::anonymous(),
+ None,
+ None,
+ )
+ .await
+ .unwrap();
+
+ let page_id = outcome.page_id.unwrap();
+ let db = rusqlite::Connection::open(store.db_path()).unwrap();
+ let rows: Vec<(String, String)> = db
+ .prepare("SELECT source_kind, source_id FROM page_evidence WHERE page_id = ?1")
+ .unwrap()
+ .query_map([page_id.as_bytes()], |row| Ok((row.get(0)?, row.get(1)?)))
+ .unwrap()
+ .collect::<Result<_, _>>()
+ .unwrap();
+ assert_eq!(rows, vec![("session".to_string(), session.to_string())]);
+ }
+
/// The multi-page provider path uses the same provenance contract for its
/// canonical session anchor, while non-session pages remain outside item 1
/// of #494.
@@ -2540,7 +2595,7 @@ mod tests {
]
});
- Consolidator::new(
+ let outcomes = Consolidator::new(
store.reader.clone(),
store.writer.clone(),
wiki.clone(),
@@ -2569,6 +2624,27 @@ mod tests {
.unwrap();
assert!(concept.frontmatter.get("agent").is_none());
assert!(concept.frontmatter.get("session_id").is_none());
+
+ // P2 (docs/design-hindsight-borrowings.md §3): unlike the anchor-only
+ // `session_id`/`agent` frontmatter stamp above, EVERY page a batch
+ // produces cites the session that produced it as evidence.
+ let db = rusqlite::Connection::open(store.db_path()).unwrap();
+ for outcome in &outcomes {
+ let page_id = outcome.page_id.unwrap();
+ let rows: Vec<(String, String)> = db
+ .prepare("SELECT source_kind, source_id FROM page_evidence WHERE page_id = ?1")
+ .unwrap()
+ .query_map([page_id.as_bytes()], |row| Ok((row.get(0)?, row.get(1)?)))
+ .unwrap()
+ .collect::<Result<_, _>>()
+ .unwrap();
+ assert_eq!(
+ rows,
+ vec![("session".to_string(), session.to_string())],
+ "path {} must cite the batch's session as evidence",
+ outcome.path.as_str()
+ );
+ }
}
/// A batch whose single update targets `path` — the model chooses this
@@ -3184,6 +3260,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -3220,6 +3297,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -3252,6 +3330,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-consolidate/src/curator.rs b/crates/ai-memory-consolidate/src/curator.rs
index 22b1ca9f..424ff031 100644
--- a/crates/ai-memory-consolidate/src/curator.rs
+++ b/crates/ai-memory-consolidate/src/curator.rs
@@ -386,6 +386,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap()
@@ -551,6 +552,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-consolidate/src/lint.rs b/crates/ai-memory-consolidate/src/lint.rs
index 079bcf7d..fd8fdc02 100644
--- a/crates/ai-memory-consolidate/src/lint.rs
+++ b/crates/ai-memory-consolidate/src/lint.rs
@@ -575,6 +575,7 @@ async fn write_report_page(
}),
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await?;
Ok(())
diff --git a/crates/ai-memory-consolidate/tests/suite/abstract_backfill.rs b/crates/ai-memory-consolidate/tests/suite/abstract_backfill.rs
index a8935971..1a9a45c5 100644
--- a/crates/ai-memory-consolidate/tests/suite/abstract_backfill.rs
+++ b/crates/ai-memory-consolidate/tests/suite/abstract_backfill.rs
@@ -44,6 +44,7 @@ async fn embedding_backfill_embeds_frontmatter_abstract() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -89,6 +90,7 @@ async fn embedding_backfill_embeds_frontmatter_abstract() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-consolidate/tests/suite/access_breadth_sweep.rs b/crates/ai-memory-consolidate/tests/suite/access_breadth_sweep.rs
index 59db0a8c..483e1c87 100644
--- a/crates/ai-memory-consolidate/tests/suite/access_breadth_sweep.rs
+++ b/crates/ai-memory-consolidate/tests/suite/access_breadth_sweep.rs
@@ -93,6 +93,7 @@ async fn write_page(writer: &WriterHandle, ws: WorkspaceId, proj: ProjectId, pat
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.expect("upsert")
diff --git a/crates/ai-memory-consolidate/tests/suite/embed_backfill.rs b/crates/ai-memory-consolidate/tests/suite/embed_backfill.rs
index 3bbda8ea..e8e13cf8 100644
--- a/crates/ai-memory-consolidate/tests/suite/embed_backfill.rs
+++ b/crates/ai-memory-consolidate/tests/suite/embed_backfill.rs
@@ -62,6 +62,7 @@ impl Fixture {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write page");
diff --git a/crates/ai-memory-consolidate/tests/suite/embeddings.rs b/crates/ai-memory-consolidate/tests/suite/embeddings.rs
index 0617fe9f..5120f9f2 100644
--- a/crates/ai-memory-consolidate/tests/suite/embeddings.rs
+++ b/crates/ai-memory-consolidate/tests/suite/embeddings.rs
@@ -68,6 +68,7 @@ async fn m9_embeddings_roundtrip_via_synthetic() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write page");
@@ -190,6 +191,7 @@ async fn m9_embeddings_roundtrip_via_synthetic() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("rewrite page");
diff --git a/crates/ai-memory-consolidate/tests/suite/lifecycle.rs b/crates/ai-memory-consolidate/tests/suite/lifecycle.rs
index 8d88ea35..d82a4c61 100644
--- a/crates/ai-memory-consolidate/tests/suite/lifecycle.rs
+++ b/crates/ai-memory-consolidate/tests/suite/lifecycle.rs
@@ -204,6 +204,7 @@ async fn m8_retention_lifecycle_end_to_end() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write page");
@@ -512,6 +513,7 @@ async fn ttl_expiry_lifecycle_end_to_end() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
};
@@ -759,6 +761,7 @@ async fn aged_decay_cleanup_stays_within_the_requested_scope() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write tombstone fixture");
@@ -869,6 +872,7 @@ async fn rewritten_decay_eviction_removes_the_file_and_entire_version_chain() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
};
let first = wiki
.write_page(write("# Rewritten\nfirst-version-marker", "first-entity"))
@@ -971,6 +975,7 @@ async fn hard_delete_preserves_a_page_recreated_at_the_same_path() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
};
let first = wiki
.write_page(write("# Recreated\nold one"))
diff --git a/crates/ai-memory-consolidate/tests/suite/local_embeddings.rs b/crates/ai-memory-consolidate/tests/suite/local_embeddings.rs
index 8d257394..97f3c765 100644
--- a/crates/ai-memory-consolidate/tests/suite/local_embeddings.rs
+++ b/crates/ai-memory-consolidate/tests/suite/local_embeddings.rs
@@ -77,6 +77,7 @@ async fn write(
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-consolidate/tests/suite/multi_machine.rs b/crates/ai-memory-consolidate/tests/suite/multi_machine.rs
index beea1d44..a1e36a5e 100644
--- a/crates/ai-memory-consolidate/tests/suite/multi_machine.rs
+++ b/crates/ai-memory-consolidate/tests/suite/multi_machine.rs
@@ -26,6 +26,7 @@ fn page(ws: WorkspaceId, proj: ProjectId, path: &str, title: &str, body: &str) -
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
diff --git a/crates/ai-memory-consolidate/tests/suite/observation_retention.rs b/crates/ai-memory-consolidate/tests/suite/observation_retention.rs
index a6e9f545..4f1d441c 100644
--- a/crates/ai-memory-consolidate/tests/suite/observation_retention.rs
+++ b/crates/ai-memory-consolidate/tests/suite/observation_retention.rs
@@ -153,6 +153,7 @@ async fn write_page(writer: &WriterHandle, ws: WorkspaceId, proj: ProjectId, pat
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.expect("upsert page")
diff --git a/crates/ai-memory-consolidate/tests/suite/recall_eval.rs b/crates/ai-memory-consolidate/tests/suite/recall_eval.rs
index 46b823e4..8ddacfad 100644
--- a/crates/ai-memory-consolidate/tests/suite/recall_eval.rs
+++ b/crates/ai-memory-consolidate/tests/suite/recall_eval.rs
@@ -138,6 +138,7 @@ async fn recall_at_5_baseline() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write page");
@@ -197,6 +198,7 @@ async fn graph_neighbor_expansion_recovers_linked_page() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write target");
@@ -212,6 +214,7 @@ async fn graph_neighbor_expansion_recovers_linked_page() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write source");
@@ -287,6 +290,7 @@ async fn entity_stream_recovers_a_probe_fts_and_graph_both_miss() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.expect("write page");
diff --git a/crates/ai-memory-consolidate/tests/suite/search_quality.rs b/crates/ai-memory-consolidate/tests/suite/search_quality.rs
index 9c43bff7..b77be865 100644
--- a/crates/ai-memory-consolidate/tests/suite/search_quality.rs
+++ b/crates/ai-memory-consolidate/tests/suite/search_quality.rs
@@ -67,6 +67,7 @@ async fn seeded() -> (
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-consolidate/tests/suite/typed_edges.rs b/crates/ai-memory-consolidate/tests/suite/typed_edges.rs
index 7b6ac511..1de37c6b 100644
--- a/crates/ai-memory-consolidate/tests/suite/typed_edges.rs
+++ b/crates/ai-memory-consolidate/tests/suite/typed_edges.rs
@@ -39,6 +39,7 @@ fn req(
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
}
}
diff --git a/crates/ai-memory-core/src/lib.rs b/crates/ai-memory-core/src/lib.rs
index 32020003..cc9c586b 100644
--- a/crates/ai-memory-core/src/lib.rs
+++ b/crates/ai-memory-core/src/lib.rs
@@ -61,8 +61,9 @@ pub use ids::{
};
pub use observation::{NewObservation, NewSession, Observation, ObservationKind};
pub use page::{
- FeedbackKind, LinkTarget, MAX_ENTITIES_PER_PAGE, MAX_ENTITY_LEN, NewPage, Page, Relation, Tier,
- frontmatter_entity_names, normalize_entities, normalize_entity,
+ FeedbackKind, LinkTarget, MAX_ENTITIES_PER_PAGE, MAX_ENTITY_LEN, NewPage, Page, PageEvidence,
+ PageEvidenceKind, Relation, Tier, frontmatter_entity_names, normalize_entities,
+ normalize_entity,
};
pub use routing_snippet::{
COMPACT_SNIPPET_BODY, MARKER_END, MARKER_START, SNIPPET_BODY, compact_block, find_marker_line,
diff --git a/crates/ai-memory-core/src/page.rs b/crates/ai-memory-core/src/page.rs
index d31c652b..e4f6a4fc 100644
--- a/crates/ai-memory-core/src/page.rs
+++ b/crates/ai-memory-core/src/page.rs
@@ -81,6 +81,76 @@ pub struct NewPage {
/// that don't declare any.
#[serde(default)]
pub entities: Vec<String>,
+ /// Evidence sources backing this write (P2,
+ /// docs/design-hindsight-borrowings.md §3): what produced or
+ /// reaffirmed this page version. The store inserts one
+ /// `page_evidence` row per entry, in the same transaction as the
+ /// page upsert (V63), `INSERT OR IGNORE` so re-citing the same
+ /// source is a no-op. Empty for hand-written pages and every
+ /// pre-2.2 caller — inert data this release, not fed into ranking
+ /// or [`crate::PageAuthority`].
+ #[serde(default)]
+ pub evidence: Vec<PageEvidence>,
+}
+
+/// One piece of evidence supporting a page write (P2,
+/// docs/design-hindsight-borrowings.md §3). Additive substrate only this
+/// release: recorded and surfaced via `SearchExplain::evidence_count`,
+/// never consulted by ranking.
+#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
+pub struct PageEvidence {
+ /// What kind of source this is.
+ pub kind: PageEvidenceKind,
+ /// The source's own identifier (a session id, observation id,
+ /// feedback row id, or reconsolidation run id) — opaque to the
+ /// store, unique within `kind` for this page.
+ pub source_id: String,
+}
+
+/// The closed vocabulary of evidence sources a page write can cite.
+/// Matches the `page_evidence.source_kind` CHECK constraint (V63).
+#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, Serialize, Deserialize, schemars::JsonSchema)]
+#[serde(rename_all = "snake_case")]
+pub enum PageEvidenceKind {
+ /// A consolidated session that produced or touched this page.
+ Session,
+ /// A raw observation cited directly (bypassing session-grain
+ /// consolidation).
+ Observation,
+ /// User/agent feedback that reaffirmed the page.
+ Feedback,
+ /// A reconsolidation pass that rewrote or re-confirmed the page.
+ Reconsolidation,
+}
+
+impl PageEvidenceKind {
+ /// Canonical short string for storage. Matches the
+ /// `page_evidence.source_kind` CHECK constraint (V63).
+ #[must_use]
+ pub const fn as_str(&self) -> &'static str {
+ match self {
+ Self::Session => "session",
+ Self::Observation => "observation",
+ Self::Feedback => "feedback",
+ Self::Reconsolidation => "reconsolidation",
+ }
+ }
+}
+
+impl FromStr for PageEvidenceKind {
+ type Err = crate::MemoryError;
+
+ fn from_str(s: &str) -> Result<Self, Self::Err> {
+ match s {
+ "session" => Ok(Self::Session),
+ "observation" => Ok(Self::Observation),
+ "feedback" => Ok(Self::Feedback),
+ "reconsolidation" => Ok(Self::Reconsolidation),
+ other => Err(crate::MemoryError::MalformedRecord(format!(
+ "unknown page evidence kind: {other}"
+ ))),
+ }
+ }
}
/// Longest accepted entity name; longer values are rejected rather than
@@ -467,6 +537,19 @@ mod tests {
assert_eq!(normalize_entities(&many).len(), MAX_ENTITIES_PER_PAGE);
}
+ #[test]
+ fn page_evidence_kind_round_trips() {
+ for k in [
+ PageEvidenceKind::Session,
+ PageEvidenceKind::Observation,
+ PageEvidenceKind::Feedback,
+ PageEvidenceKind::Reconsolidation,
+ ] {
+ assert_eq!(k.as_str().parse::<PageEvidenceKind>().unwrap(), k);
+ }
+ assert!("nope".parse::<PageEvidenceKind>().is_err());
+ }
+
#[test]
fn frontmatter_entity_names_merges_entities_and_tags_leniently() {
// Explicit entities first (they win the cap), then tags; dupes drop.
diff --git a/crates/ai-memory-hooks/src/router.rs b/crates/ai-memory-hooks/src/router.rs
index 1b3d909d..cae2a3de 100644
--- a/crates/ai-memory-hooks/src/router.rs
+++ b/crates/ai-memory-hooks/src/router.rs
@@ -2863,6 +2863,7 @@ async fn process_authorized(
// identity. NULL stays anonymous/shared, including rows that
// predate owner recording.
actor: session_actor.clone(),
+ evidence: Vec::new(),
})
.await?;
// The baton follows the SESSION's owner, so it reaches the person who
@@ -3391,6 +3392,7 @@ async fn consolidate_or_synth(
}),
author_id: None,
actor,
+ evidence: Vec::new(),
})
.await?;
let _ = state
@@ -9582,6 +9584,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -10316,6 +10319,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
diff --git a/crates/ai-memory-hooks/src/synth.rs b/crates/ai-memory-hooks/src/synth.rs
index 540c7bed..cfef27a8 100644
--- a/crates/ai-memory-hooks/src/synth.rs
+++ b/crates/ai-memory-hooks/src/synth.rs
@@ -69,6 +69,7 @@ pub fn synthesize_session_page(
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
diff --git a/crates/ai-memory-mcp/src/admin.rs b/crates/ai-memory-mcp/src/admin.rs
index 40f515f8..a3b34e35 100644
--- a/crates/ai-memory-mcp/src/admin.rs
+++ b/crates/ai-memory-mcp/src/admin.rs
@@ -6044,6 +6044,7 @@ async fn copy_purge_merge(
}),
author_id: None,
actor: actor.clone(),
+ evidence: Vec::new(),
})
.await
{
@@ -6538,6 +6539,7 @@ async fn handle_write_page(
admission_ctx,
author_id,
actor,
+ evidence: Vec::new(),
})
.await
.map_err(|e| internal_err(e.to_string()))?;
@@ -8613,6 +8615,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8768,6 +8771,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8907,6 +8911,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -9024,6 +9029,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/src/server.rs b/crates/ai-memory-mcp/src/server.rs
index 87bd7d1a..34ef4df1 100644
--- a/crates/ai-memory-mcp/src/server.rs
+++ b/crates/ai-memory-mcp/src/server.rs
@@ -3078,6 +3078,7 @@ impl AiMemoryServer {
admission_ctx,
author_id,
actor,
+ evidence: Vec::new(),
})
.await
.map_err(|e| McpError::internal_error(e.to_string(), None))?;
@@ -4788,6 +4789,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -5084,6 +5086,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -6023,6 +6026,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
};
let target_id = store
.writer
@@ -6712,6 +6716,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: vec!["postgres".into()],
+ evidence: Vec::new(),
};
store.writer.upsert_page(v1.clone()).await.unwrap();
let between = jiff::Timestamp::now().to_string();
@@ -6914,6 +6919,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: vec!["nats jetstream".into()],
+ evidence: Vec::new(),
};
store.writer.upsert_page(entity_only.clone()).await.unwrap();
entity_only.path = PagePath::new("concepts/linked.md").unwrap();
@@ -6936,6 +6942,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -7025,6 +7032,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -7566,6 +7574,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -7649,6 +7658,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8110,6 +8120,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8162,6 +8173,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8642,6 +8654,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8660,6 +8673,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8678,6 +8692,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8775,6 +8790,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8794,6 +8810,7 @@ mod tests {
author_id: None,
expires_at: Some("2020-01-01T23:59:59Z".parse().unwrap()),
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -8912,6 +8929,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -9200,6 +9218,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -10792,6 +10811,7 @@ mod tests {
author_id: Some(bob_user_id),
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_audit_log.rs b/crates/ai-memory-mcp/tests/suite/admin_audit_log.rs
index ebd12471..99ca92f6 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_audit_log.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_audit_log.rs
@@ -63,6 +63,7 @@ async fn seed_page(store: &Store, workspace: &str, project: &str, path: &str, bo
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_backup.rs b/crates/ai-memory-mcp/tests/suite/admin_backup.rs
index c3f4a4c2..bdb474e7 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_backup.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_backup.rs
@@ -75,6 +75,7 @@ async fn seed_page(state: &AdminState, store: &Store, path: &str, body: &str) {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_move.rs b/crates/ai-memory-mcp/tests/suite/admin_move.rs
index 0e504b67..32cc65b0 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_move.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_move.rs
@@ -153,6 +153,7 @@ async fn seed_page_with_metadata(
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -677,6 +678,7 @@ async fn true_move_stale_source_write_fails_before_creating_file() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap_err();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_move_session.rs b/crates/ai-memory-mcp/tests/suite/admin_move_session.rs
index f250b746..6bb9994f 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_move_session.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_move_session.rs
@@ -215,6 +215,7 @@ async fn seed_session(
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -451,6 +452,7 @@ async fn move_session_page_collision_returns_409_and_leaves_source_intact() {
author_id: None,
expires_at: None,
entities: vec![],
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_phase3.rs b/crates/ai-memory-mcp/tests/suite/admin_phase3.rs
index 77fb0765..73c9f43c 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_phase3.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_phase3.rs
@@ -480,6 +480,7 @@ async fn reorg_live_graveyards_only_default_workspace_pages() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -509,6 +510,7 @@ async fn reorg_live_graveyards_only_default_workspace_pages() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -589,6 +591,7 @@ async fn lint_dry_run_returns_lint_report_shape() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -758,6 +761,7 @@ async fn embed_all_projects_rebuilds_workspace_projects() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -775,6 +779,7 @@ async fn embed_all_projects_rebuilds_workspace_projects() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -867,6 +872,7 @@ async fn commit_with_new_page_returns_committed_true_and_40char_oid() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -917,6 +923,7 @@ async fn checkpoints_list_and_restore_page_round_trip() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -936,6 +943,7 @@ async fn checkpoints_list_and_restore_page_round_trip() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_purge.rs b/crates/ai-memory-mcp/tests/suite/admin_purge.rs
index b4a2f511..3ad4d5d3 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_purge.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_purge.rs
@@ -134,6 +134,7 @@ async fn seed_ended_session_summary(
admission_ctx: None,
author_id: None,
actor: ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -180,6 +181,7 @@ async fn seed_two_projects(store: &Store, wiki: &Wiki) -> (WorkspaceId, ProjectI
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -196,6 +198,7 @@ async fn seed_two_projects(store: &Store, wiki: &Wiki) -> (WorkspaceId, ProjectI
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -340,6 +343,7 @@ async fn purge_session_keeps_same_path_in_sibling_project() {
admission_ctx: None,
author_id: None,
actor: ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_read_page.rs b/crates/ai-memory-mcp/tests/suite/admin_read_page.rs
index 57e8f50a..95d3c675 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_read_page.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_read_page.rs
@@ -80,6 +80,7 @@ async fn read_page_falls_back_to_db_when_file_missing() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -130,6 +131,7 @@ async fn read_page_serves_on_disk_page() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -180,6 +182,7 @@ async fn read_page_does_not_fall_back_when_disk_frontmatter_is_malformed() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_rename.rs b/crates/ai-memory-mcp/tests/suite/admin_rename.rs
index 2ef42c42..e14ee18e 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_rename.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_rename.rs
@@ -79,6 +79,7 @@ async fn seed_page(store: &Store, wiki: &Wiki, project: &str) -> String {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/admin_status_search.rs b/crates/ai-memory-mcp/tests/suite/admin_status_search.rs
index 1ef5417a..1e258882 100644
--- a/crates/ai-memory-mcp/tests/suite/admin_status_search.rs
+++ b/crates/ai-memory-mcp/tests/suite/admin_status_search.rs
@@ -65,6 +65,7 @@ async fn seed_page(store: &Store, title: &str, path: &str, body: &str) {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
};
store.writer.upsert_page(page).await.unwrap();
}
@@ -156,6 +157,7 @@ async fn list_projects_returns_workspace_project_pairs() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-mcp/tests/suite/autoscope_multiuser.rs b/crates/ai-memory-mcp/tests/suite/autoscope_multiuser.rs
index c673faa5..517349f9 100644
--- a/crates/ai-memory-mcp/tests/suite/autoscope_multiuser.rs
+++ b/crates/ai-memory-mcp/tests/suite/autoscope_multiuser.rs
@@ -125,6 +125,7 @@ impl MultiUserHarness {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.expect("seed page");
diff --git a/crates/ai-memory-mcp/tests/suite/stress_autoscope.rs b/crates/ai-memory-mcp/tests/suite/stress_autoscope.rs
index 4a67e638..e72b4661 100644
--- a/crates/ai-memory-mcp/tests/suite/stress_autoscope.rs
+++ b/crates/ai-memory-mcp/tests/suite/stress_autoscope.rs
@@ -123,6 +123,7 @@ impl Harness {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.expect("seed page");
diff --git a/crates/ai-memory-store/migrations/V63__page_evidence.sql b/crates/ai-memory-store/migrations/V63__page_evidence.sql
new file mode 100644
index 00000000..a300f496
--- /dev/null
+++ b/crates/ai-memory-store/migrations/V63__page_evidence.sql
@@ -0,0 +1,31 @@
+-- Belief-strength evidence substrate (P2, docs/design-hindsight-borrowings.md
+-- §3): record what produced or reaffirmed each page version, so retrieval
+-- can eventually surface "how many independent sources support this" as a
+-- confidence signal. Additive only, no backfill: evidence accrues going
+-- forward from the write path (V63 threads it through
+-- `NewPage`/`WritePageRequest`), and a page with zero rows simply reads as
+-- "unknown" (count 0), not "unsupported".
+--
+-- This release ships the substrate and an explain-only surface
+-- (`SearchExplain::evidence_count`) — nothing here feeds `PageAuthority` or
+-- ranking. The confidence -> authority flip is deferred behind the R2 eval.
+--
+-- `source_kind` is a closed vocabulary matching
+-- `ai_memory_core::PageEvidenceKind`: 'session' (a consolidated session),
+-- 'observation' (a raw observation cited directly), 'feedback' (a
+-- reaffirming `page_feedback` row), 'reconsolidation' (a rewrite/re-confirm
+-- pass). `source_id` is opaque to the store — whatever id the citing kind
+-- uses (a session id, observation id, etc.) — and the PK makes re-citing the
+-- same source from the same page idempotent (`INSERT OR IGNORE`), matching
+-- V56/V58's WITHOUT ROWID join-table style.
+--
+-- `ON DELETE CASCADE` follows `page_id` through `pages` deletes (purge,
+-- graveyard), so evidence never outlives the page version it supports.
+
+CREATE TABLE page_evidence (
+ page_id BLOB NOT NULL REFERENCES pages(id) ON DELETE CASCADE,
+ source_kind TEXT NOT NULL CHECK (source_kind IN ('session','observation','feedback','reconsolidation')),
+ source_id TEXT NOT NULL,
+ created_at INTEGER NOT NULL,
+ PRIMARY KEY (page_id, source_kind, source_id)
+) WITHOUT ROWID;
diff --git a/crates/ai-memory-store/src/api_credentials.rs b/crates/ai-memory-store/src/api_credentials.rs
index 73b6fc25..d6f3e153 100644
--- a/crates/ai-memory-store/src/api_credentials.rs
+++ b/crates/ai-memory-store/src/api_credentials.rs
@@ -411,7 +411,7 @@ mod tests {
|row| row.get(0),
)
.unwrap();
- assert_eq!(version, 62, "update the pin when adding a migration");
+ assert_eq!(version, 63, "update the pin when adding a migration");
let cols: i64 = conn
.query_row(
"SELECT COUNT(*) FROM pragma_table_info('users') WHERE name = 'token_hash'",
@@ -422,6 +422,32 @@ mod tests {
assert_eq!(cols, 1);
}
+ #[test]
+ fn v63_page_evidence_table_applies_and_is_idempotent() {
+ let mut conn = Connection::open_in_memory().unwrap();
+ conn.pragma_update(None, "foreign_keys", "ON").unwrap();
+ crate::migrations::run(&mut conn).unwrap();
+ // Re-running (refinery's own idempotency: already-applied versions
+ // are skipped) must not fail or duplicate the migration history row.
+ crate::migrations::run(&mut conn).unwrap();
+ let history_rows: i64 = conn
+ .query_row(
+ "SELECT COUNT(*) FROM refinery_schema_history WHERE version = 63",
+ [],
+ |row| row.get(0),
+ )
+ .unwrap();
+ assert_eq!(history_rows, 1, "V63 must be recorded exactly once");
+ let cols: i64 = conn
+ .query_row(
+ "SELECT COUNT(*) FROM pragma_table_info('page_evidence')",
+ [],
+ |row| row.get(0),
+ )
+ .unwrap();
+ assert_eq!(cols, 4, "page_id, source_kind, source_id, created_at");
+ }
+
#[test]
fn api_credentials_v55_human_create_has_no_key() {
let mut conn = Connection::open_in_memory().unwrap();
diff --git a/crates/ai-memory-store/src/lib.rs b/crates/ai-memory-store/src/lib.rs
index 363f6846..775f974a 100644
--- a/crates/ai-memory-store/src/lib.rs
+++ b/crates/ai-memory-store/src/lib.rs
@@ -198,8 +198,9 @@ mod tests {
use ai_memory_core::{
ActorContext, AgentKind, HandoffAcceptance, HandoffId, HandoffState, LinkTarget,
ManagedRunId, NewHandoff, NewObservation, NewPage, NewSession, NewWorkstreamEvent,
- ObservationId, ObservationKind, PageId, PagePath, ProjectId, Sanitized, Sanitizer,
- SessionId, Tier, UserId, WorkspaceId, WorkstreamEventKind, WorkstreamId,
+ ObservationId, ObservationKind, PageEvidence, PageEvidenceKind, PageId, PagePath,
+ ProjectId, Sanitized, Sanitizer, SessionId, Tier, UserId, WorkspaceId, WorkstreamEventKind,
+ WorkstreamId,
};
use rusqlite::{Connection, params};
use sha2::{Digest, Sha256};
@@ -246,6 +247,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
@@ -2954,6 +2956,139 @@ mod tests {
);
}
+ /// P2 (docs/design-hindsight-borrowings.md §3), ship scope for 2.2.0:
+ /// evidence is substrate + explain surfacing ONLY. `hybrid_search_explained`
+ /// reports `evidence_count`, but citing a page from two distinct sessions
+ /// must not move the default (non-explained) path's ranking at all —
+ /// same hit order, same `rank` scores, before and after evidence accrues.
+ #[tokio::test]
+ async fn hybrid_search_explained_reports_evidence_count_without_moving_default_ranking() {
+ let tmp = TempDir::new().unwrap();
+ let store = Store::open(tmp.path()).unwrap();
+ let ws = store
+ .writer
+ .get_or_create_workspace("default")
+ .await
+ .unwrap();
+ let proj = store
+ .writer
+ .get_or_create_project(ws, "ai-memory", None)
+ .await
+ .unwrap();
+
+ let page_a = sample_page(ws, proj, "a.md", "evidence probe alpha content");
+ let page_b = sample_page(ws, proj, "b.md", "evidence probe beta content");
+ store.writer.upsert_page(page_a.clone()).await.unwrap();
+ store.writer.upsert_page(page_b).await.unwrap();
+
+ let query = || "evidence probe".to_string();
+ let baseline = store
+ .reader
+ .hybrid_search(
+ ws,
+ proj,
+ query(),
+ None,
+ String::new(),
+ String::new(),
+ 0,
+ 10,
+ None,
+ )
+ .await
+ .unwrap();
+ let baseline_paths: Vec<&str> = baseline.iter().map(|h| h.path.as_str()).collect();
+ let baseline_ranks: Vec<f64> = baseline.iter().map(|h| h.rank).collect();
+
+ // Cite `a.md` from two distinct sessions. The body/frontmatter are
+ // byte-identical each time, so this hits the content short-circuit
+ // (ops::upsert_page_in_tx) — same page id, no new version, nothing
+ // that could feed `fused`/`authority` changes — and only the
+ // `page_evidence` rows accrue.
+ let mut with_evidence = page_a.clone();
+ with_evidence.evidence = vec![PageEvidence {
+ kind: PageEvidenceKind::Session,
+ source_id: "session-1".into(),
+ }];
+ store
+ .writer
+ .upsert_page(with_evidence.clone())
+ .await
+ .unwrap();
+ with_evidence.evidence = vec![PageEvidence {
+ kind: PageEvidenceKind::Session,
+ source_id: "session-2".into(),
+ }];
+ store.writer.upsert_page(with_evidence).await.unwrap();
+
+ let after = store
+ .reader
+ .hybrid_search(
+ ws,
+ proj,
+ query(),
+ None,
+ String::new(),
+ String::new(),
+ 0,
+ 10,
+ None,
+ )
+ .await
+ .unwrap();
+ let after_paths: Vec<&str> = after.iter().map(|h| h.path.as_str()).collect();
+ let after_ranks: Vec<f64> = after.iter().map(|h| h.rank).collect();
+ assert_eq!(
+ baseline_paths, after_paths,
+ "evidence must not reorder hits"
+ );
+ assert_eq!(
+ baseline_ranks, after_ranks,
+ "evidence must not change the rank score on the default path"
+ );
+
+ let explained = store
+ .reader
+ .hybrid_search_explained(
+ ws,
+ proj,
+ query(),
+ None,
+ String::new(),
+ String::new(),
+ 0,
+ 10,
+ None,
+ )
+ .await
+ .unwrap();
+ let (_, a_details) = explained
+ .iter()
+ .find(|(hit, _)| hit.path.as_str() == "a.md")
+ .unwrap();
+ let (_, b_details) = explained
+ .iter()
+ .find(|(hit, _)| hit.path.as_str() == "b.md")
+ .unwrap();
+ assert_eq!(
+ a_details.evidence_count,
+ Some(2),
+ "two distinct sessions cited a.md"
+ );
+ assert_eq!(
+ b_details.evidence_count,
+ Some(0),
+ "b.md has no evidence rows — explained still reports Some(0), not None"
+ );
+ // Explain must still agree with the default path's own ordering.
+ let explained_paths: Vec<&str> =
+ explained.iter().map(|(hit, _)| hit.path.as_str()).collect();
+ assert_eq!(
+ after_paths, explained_paths,
+ "explain must not change ranking"
+ );
+ }
+
#[tokio::test]
async fn observation_fts_finds_raw_fallback_hits() {
let tmp = TempDir::new().unwrap();
@@ -4336,6 +4471,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
};
store.writer.upsert_page(page).await.unwrap();
diff --git a/crates/ai-memory-store/src/ops.rs b/crates/ai-memory-store/src/ops.rs
index 84db82b8..1956c065 100644
--- a/crates/ai-memory-store/src/ops.rs
+++ b/crates/ai-memory-store/src/ops.rs
@@ -8,8 +8,8 @@ use std::collections::BTreeSet;
use ai_memory_core::{
AgentKind, EntityId, HandoffAcceptance, HandoffId, IdentityKey, LinkTarget, NewHandoff,
- NewObservation, NewPage, NewSession, ObservationId, ObservationKind, OwnerFilter, PageId,
- PagePath, ProjectId, SessionId, WorkspaceId,
+ NewObservation, NewPage, NewSession, ObservationId, ObservationKind, OwnerFilter, PageEvidence,
+ PageId, PagePath, ProjectId, SessionId, WorkspaceId,
};
/// Summary returned by [`reorg_sessions`] and exposed via
@@ -871,7 +871,13 @@ pub(crate) fn upsert_page_in_tx(
&& existing.tier == tier_str
&& existing.pinned == i64::from(page.pinned)
{
- return PageId::from_slice(&existing.id).map_err(StoreError::from);
+ let unchanged_id = PageId::from_slice(&existing.id).map_err(StoreError::from)?;
+ // The content short-circuit skips a new version row, but a
+ // reconsolidation from a different session still cites the
+ // page it reaffirmed (P2, docs/design-hindsight-borrowings.md
+ // §3) — record the evidence against the still-current id.
+ insert_evidence_in_tx(tx, &unchanged_id, &page.evidence, now)?;
+ return Ok(unchanged_id);
}
let frontmatter_str = stamped_frontmatter(conformed, now)?;
let new_id = PageId::new();
@@ -915,6 +921,7 @@ pub(crate) fn upsert_page_in_tx(
replace_links_in_tx(tx, &new_id, page)?;
attach_entities_in_tx(tx, &new_id, page, now)?;
refresh_incoming_links_for_path(tx, page, &new_id)?;
+ insert_evidence_in_tx(tx, &new_id, &page.evidence, now)?;
audit(
tx,
"supersede_page",
@@ -955,6 +962,7 @@ pub(crate) fn upsert_page_in_tx(
replace_links_in_tx(tx, &new_id, page)?;
attach_entities_in_tx(tx, &new_id, page, now)?;
refresh_incoming_links_for_path(tx, page, &new_id)?;
+ insert_evidence_in_tx(tx, &new_id, &page.evidence, now)?;
audit(
tx,
"create_page",
@@ -1056,6 +1064,28 @@ fn replace_links_in_tx(
Ok(())
}
+/// Record a page write's evidence sources (P2,
+/// docs/design-hindsight-borrowings.md §3), in the same transaction as the
+/// page upsert. `INSERT OR IGNORE` on the `(page_id, source_kind,
+/// source_id)` PK makes re-citing the same source a no-op — a session that
+/// reconsolidates the same path twice does not inflate the count. Empty
+/// `evidence` (every pre-2.2 caller) inserts nothing.
+fn insert_evidence_in_tx(
+ tx: &rusqlite::Transaction<'_>,
+ page_id: &PageId,
+ evidence: &[PageEvidence],
+ now: i64,
+) -> StoreResult<()> {
+ for e in evidence {
+ tx.execute(
+ "INSERT OR IGNORE INTO page_evidence (page_id, source_kind, source_id, created_at) \
+ VALUES (?1, ?2, ?3, ?4)",
+ params![page_id.as_bytes(), e.kind.as_str(), e.source_id, now],
+ )?;
+ }
+ Ok(())
+}
+
/// Resolve a link target to the latest page id it points at, or `None` if the
/// target workspace / project / page does not exist yet (an unresolved forward
/// link). A bare link resolves within the source page's own project; a
@@ -4709,8 +4739,8 @@ pub(crate) mod tests {
//! one-line diff instead of a cascading e2e failure.
use super::*;
use ai_memory_core::{
- FeedbackKind, LinkTarget, NewHandoff, NewPage, NewSession, PagePath, ProjectId, Tier,
- UserId, WorkspaceId,
+ FeedbackKind, LinkTarget, NewHandoff, NewPage, NewSession, PageEvidence, PageEvidenceKind,
+ PagePath, ProjectId, Tier, UserId, WorkspaceId,
};
use rusqlite::Connection;
use std::io::Write;
@@ -6276,6 +6306,7 @@ pub(crate) mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
@@ -6744,6 +6775,102 @@ pub(crate) mod tests {
assert_eq!(total, 1, "no duplicate row for unchanged content");
}
+ fn evidence_count(conn: &Connection, page_id: &PageId) -> i64 {
+ conn.query_row(
+ "SELECT COUNT(*) FROM page_evidence WHERE page_id = ?1",
+ params![page_id.as_bytes()],
+ |r| r.get(0),
+ )
+ .unwrap()
+ }
+
+ /// P2 (docs/design-hindsight-borrowings.md §3): a page write's cited
+ /// evidence accrues in-transaction with the upsert. Reconsolidating the
+ /// same (unchanged) content from a different session still hits the
+ /// content short-circuit — same page id, no new version — but the new
+ /// session's citation lands, and the SAME session citing it again is a
+ /// no-op (`INSERT OR IGNORE` on the `(page_id, source_kind, source_id)`
+ /// PK), never inflating the count.
+ #[test]
+ fn reconsolidating_the_same_page_accrues_evidence_per_distinct_session() {
+ let (_tmp, mut conn, ws, proj) = fresh_db();
+ let mut p = page(ws, proj, "notes/foo.md", "same body");
+ p.evidence = vec![PageEvidence {
+ kind: PageEvidenceKind::Session,
+ source_id: "session-a".into(),
+ }];
+ let id = upsert_page(&mut conn, &p).unwrap();
+ assert_eq!(evidence_count(&conn, &id), 1);
+
+ p.evidence = vec![PageEvidence {
+ kind: PageEvidenceKind::Session,
+ source_id: "session-b".into(),
+ }];
+ let id2 = upsert_page(&mut conn, &p).unwrap();
+ assert_eq!(id2, id, "unchanged content must not create a new version");
+ assert_eq!(evidence_count(&conn, &id), 2);
+
+ let id3 = upsert_page(&mut conn, &p).unwrap();
+ assert_eq!(id3, id);
+ assert_eq!(
+ evidence_count(&conn, &id),
+ 2,
+ "re-citing the same session is a no-op"
+ );
+ }
+
+ /// A page written with no evidence stays at count 0 ("unknown"), and a
+ /// version created by a real content change (not the idempotent
+ /// short-circuit) starts its own, separate evidence trail.
+ #[test]
+ fn upsert_page_with_no_evidence_stays_at_zero_and_new_versions_start_fresh() {
+ let (_tmp, mut conn, ws, proj) = fresh_db();
+ let id1 = upsert_page(&mut conn, &page(ws, proj, "notes/foo.md", "v1 body")).unwrap();
+ assert_eq!(evidence_count(&conn, &id1), 0);
+
+ let mut p2 = page(ws, proj, "notes/foo.md", "v2 body");
+ p2.evidence = vec![PageEvidence {
+ kind: PageEvidenceKind::Session,
+ source_id: "session-a".into(),
+ }];
+ let id2 = upsert_page(&mut conn, &p2).unwrap();
+ assert_ne!(id2, id1, "changed body supersedes to a new version");
+ assert_eq!(
+ evidence_count(&conn, &id1),
+ 0,
+ "the old version is untouched"
+ );
+ assert_eq!(evidence_count(&conn, &id2), 1);
+ }
+
+ /// Purging a page must take its evidence with it (`ON DELETE CASCADE`,
+ /// V63) — evidence never outlives the page version it supports.
+ #[test]
+ fn deleting_a_page_cascades_its_evidence_rows() {
+ let (_tmp, mut conn, ws, proj) = fresh_db();
+ let mut p = page(ws, proj, "notes/foo.md", "body");
+ p.evidence = vec![PageEvidence {
+ kind: PageEvidenceKind::Session,
+ source_id: "session-a".into(),
+ }];
+ let id = upsert_page(&mut conn, &p).unwrap();
+ assert_eq!(evidence_count(&conn, &id), 1);
+
+ delete_page(
+ &mut conn,
+ ws,
+ proj,
+ &PagePath::new("notes/foo.md").unwrap(),
+ None,
+ )
+ .unwrap();
+ assert_eq!(
+ evidence_count(&conn, &id),
+ 0,
+ "ON DELETE CASCADE must drop evidence with the page"
+ );
+ }
+
/// OKF conformance happens at this choke point for every writer
/// (docs/okf.md): a page stored with bare frontmatter comes back
/// with the required `type`, a `generated {by, at}` stanza, and
diff --git a/crates/ai-memory-store/src/reader.rs b/crates/ai-memory-store/src/reader.rs
index 4abd8240..880916fb 100644
--- a/crates/ai-memory-store/src/reader.rs
+++ b/crates/ai-memory-store/src/reader.rs
@@ -605,6 +605,15 @@ pub struct SearchExplain {
/// degraded, or when the hit fell outside the bounded judged prefix.
#[serde(skip_serializing_if = "Option::is_none")]
pub rerank_score: Option<f32>,
+ /// Number of `page_evidence` rows citing this page version (P2,
+ /// docs/design-hindsight-borrowings.md §3) — how many
+ /// sessions/observations/feedback/reconsolidation passes produced or
+ /// reaffirmed it. Populated only on the explained path
+ /// ([`Reader::hybrid_search_explained`]), batch-fetched after fusion;
+ /// `None` on the default (non-explained) path. Inert this release: it
+ /// never feeds `fused`/`authority` or changes ranking.
+ #[serde(skip_serializing_if = "Option::is_none")]
+ pub evidence_count: Option<u32>,
}
/// One hit returned by [`ReaderPool::search_pages`].
@@ -3891,6 +3900,53 @@ impl ReaderPool {
.await
}
+ /// Number of `page_evidence` rows for each of `page_ids` (P2,
+ /// docs/design-hindsight-borrowings.md §3): what produced or
+ /// reaffirmed that page version. One batch query for the whole
+ /// result page — never one per hit — so
+ /// [`Self::hybrid_search_explained`] can attach
+ /// `SearchExplain::evidence_count` without touching the hot,
+ /// non-explained default path. A page id with zero evidence rows is
+ /// simply absent from the map; callers read that as count 0
+ /// ("unknown", not "unsupported").
+ ///
+ /// # Errors
+ /// Propagates any SQL or pool error.
+ pub async fn page_evidence_counts(
+ &self,
+ page_ids: &[PageId],
+ ) -> StoreResult<std::collections::HashMap<PageId, u32>> {
+ if page_ids.is_empty() {
+ return Ok(std::collections::HashMap::new());
+ }
+ let page_id_blobs: Vec<Value> = page_ids
+ .iter()
+ .map(|id| Value::Blob(id.as_bytes().to_vec()))
+ .collect();
+ self.with_conn(move |conn| {
+ let placeholders = std::iter::repeat_n("?", page_id_blobs.len())
+ .collect::<Vec<_>>()
+ .join(", ");
+ let sql = format!(
+ "SELECT page_id, COUNT(*) FROM page_evidence \
+ WHERE page_id IN ({placeholders}) GROUP BY page_id"
+ );
+ let mut stmt = conn.prepare(&sql)?;
+ let rows = stmt.query_map(params_from_iter(page_id_blobs.iter()), |row| {
+ let id: Vec<u8> = row.get(0)?;
+ let n: i64 = row.get(1)?;
+ Ok((id, u32::try_from(n).unwrap_or(u32::MAX)))
+ })?;
+ let mut out = std::collections::HashMap::new();
+ for r in rows {
+ let (id, n) = r?;
+ out.insert(PageId::from_slice(&id)?, n);
+ }
+ Ok(out)
+ })
+ .await
+ }
+
/// Rank pages by how many of the query's tokens match their indexed
/// entities, weighting each match by inverse entity frequency — a
/// query token matching an entity that appears on 2 pages is a much
@@ -4546,7 +4602,7 @@ impl ReaderPool {
limit: usize,
expiry_cutoff_us: Option<i64>,
) -> StoreResult<Vec<(PageHit, SearchExplain)>> {
- Ok(self
+ let hits = self
.hybrid_search_inner(
workspace_id,
project_id,
@@ -4559,9 +4615,19 @@ impl ReaderPool {
expiry_cutoff_us,
true,
)
- .await?
+ .await?;
+ // Evidence counts (P2, docs/design-hindsight-borrowings.md §3) are
+ // explain-only: one batch query over the already-fused result page
+ // ids, never a per-hit query on the hot default path.
+ let page_ids: Vec<PageId> = hits.iter().map(|(hit, _)| hit.id).collect();
+ let counts = self.page_evidence_counts(&page_ids).await?;
+ Ok(hits
.into_iter()
- .map(|(hit, explain)| (hit, explain.unwrap_or_default()))
+ .map(|(hit, explain)| {
+ let mut explain = explain.unwrap_or_default();
+ explain.evidence_count = Some(counts.get(&hit.id).copied().unwrap_or(0));
+ (hit, explain)
+ })
.collect())
}
diff --git a/crates/ai-memory-store/src/writer.rs b/crates/ai-memory-store/src/writer.rs
index 5005751f..6c10d54f 100644
--- a/crates/ai-memory-store/src/writer.rs
+++ b/crates/ai-memory-store/src/writer.rs
@@ -3546,6 +3546,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
diff --git a/crates/ai-memory-store/tests/suite/access_breadth.rs b/crates/ai-memory-store/tests/suite/access_breadth.rs
index 89486823..30322eee 100644
--- a/crates/ai-memory-store/tests/suite/access_breadth.rs
+++ b/crates/ai-memory-store/tests/suite/access_breadth.rs
@@ -125,6 +125,7 @@ async fn per_actor_rows_accumulate_without_replacing_the_scalar() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -224,6 +225,7 @@ async fn a_stale_page_id_does_not_cost_the_rest_of_the_batch_its_bump() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap(),
diff --git a/crates/ai-memory-store/tests/suite/audit_log.rs b/crates/ai-memory-store/tests/suite/audit_log.rs
index 30f438fa..a59df690 100644
--- a/crates/ai-memory-store/tests/suite/audit_log.rs
+++ b/crates/ai-memory-store/tests/suite/audit_log.rs
@@ -26,6 +26,7 @@ async fn seed_page(
author_id,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-store/tests/suite/fts_drift_status.rs b/crates/ai-memory-store/tests/suite/fts_drift_status.rs
index 2242000c..cd108ee0 100644
--- a/crates/ai-memory-store/tests/suite/fts_drift_status.rs
+++ b/crates/ai-memory-store/tests/suite/fts_drift_status.rs
@@ -41,6 +41,7 @@ async fn page_fts_rows_report_index_drift() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-store/tests/suite/multi_session.rs b/crates/ai-memory-store/tests/suite/multi_session.rs
index fcf7a391..fce7ff76 100644
--- a/crates/ai-memory-store/tests/suite/multi_session.rs
+++ b/crates/ai-memory-store/tests/suite/multi_session.rs
@@ -78,6 +78,7 @@ fn page(ws: WorkspaceId, proj: ProjectId, path: &str, title: &str, body: &str) -
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
diff --git a/crates/ai-memory-store/tests/suite/retrieval_tuning_streams.rs b/crates/ai-memory-store/tests/suite/retrieval_tuning_streams.rs
index 428abb51..6774e6c1 100644
--- a/crates/ai-memory-store/tests/suite/retrieval_tuning_streams.rs
+++ b/crates/ai-memory-store/tests/suite/retrieval_tuning_streams.rs
@@ -26,6 +26,7 @@ fn page(
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
diff --git a/crates/ai-memory-store/tests/suite/slot_visibility.rs b/crates/ai-memory-store/tests/suite/slot_visibility.rs
index 01babde2..4c903039 100644
--- a/crates/ai-memory-store/tests/suite/slot_visibility.rs
+++ b/crates/ai-memory-store/tests/suite/slot_visibility.rs
@@ -55,6 +55,7 @@ async fn write_slot(store: &Store, ws: WorkspaceId, proj: ProjectId, path: &str)
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -561,6 +562,7 @@ async fn expiry_and_slot_visibility_both_apply() {
author_id: None,
expires_at,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-web/tests/suite/routes.rs b/crates/ai-memory-web/tests/suite/routes.rs
index 6459a657..1086fdab 100644
--- a/crates/ai-memory-web/tests/suite/routes.rs
+++ b/crates/ai-memory-web/tests/suite/routes.rs
@@ -40,6 +40,7 @@ fn new_page(
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
}
}
@@ -61,6 +62,7 @@ fn wiki_req(
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
}
}
@@ -623,6 +625,7 @@ async fn api_pages_derives_kind_from_path_when_frontmatter_absent() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -644,6 +647,7 @@ async fn api_pages_derives_kind_from_path_when_frontmatter_absent() {
author_id: None,
expires_at: None,
entities: Vec::new(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -2598,6 +2602,7 @@ async fn api_page_handler_emits_etag_and_supports_if_none_match() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -2679,6 +2684,7 @@ async fn api_page_handler_etag_differs_per_page() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -2694,6 +2700,7 @@ async fn api_page_handler_etag_differs_per_page() {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-wiki/src/migrations/m2026_09_okf_conformance.rs b/crates/ai-memory-wiki/src/migrations/m2026_09_okf_conformance.rs
index 2004f6ed..90d0a731 100644
--- a/crates/ai-memory-wiki/src/migrations/m2026_09_okf_conformance.rs
+++ b/crates/ai-memory-wiki/src/migrations/m2026_09_okf_conformance.rs
@@ -426,6 +426,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -799,6 +800,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -882,6 +884,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
diff --git a/crates/ai-memory-wiki/src/wiki.rs b/crates/ai-memory-wiki/src/wiki.rs
index e5a032b5..58d0aecb 100644
--- a/crates/ai-memory-wiki/src/wiki.rs
+++ b/crates/ai-memory-wiki/src/wiki.rs
@@ -733,6 +733,7 @@ impl Wiki {
author_id: None,
expires_at: meta.expires_at,
entities: meta.entities,
+ evidence: Vec::new(),
})
.await?;
Ok(id)
@@ -1458,6 +1459,7 @@ impl Wiki {
author_id,
expires_at,
entities,
+ evidence: Vec::new(),
};
let result = {
@@ -1572,6 +1574,7 @@ impl Wiki {
author_id: None,
expires_at: meta.expires_at,
entities: meta.entities,
+ evidence: Vec::new(),
})
.await?;
Ok(id)
@@ -1924,6 +1927,7 @@ impl Wiki {
author_id: req.author_id,
expires_at: parse_expires_at(&req.path, &req.frontmatter)?,
entities: parse_entities(&req.path, &req.frontmatter)?,
+ evidence: req.evidence.clone(),
})
})
.collect::<WikiResult<Vec<_>>>()?;
@@ -2049,6 +2053,7 @@ impl Wiki {
admission_ctx,
author_id,
actor,
+ evidence,
} = req;
// Defence-in-depth: scrub the body before we touch disk or the
@@ -2161,6 +2166,7 @@ impl Wiki {
author_id,
expires_at,
entities,
+ evidence,
})
.await
{
@@ -2295,6 +2301,12 @@ pub struct WritePageRequest {
/// (consolidator, lint rewriters) that build `WritePageRequest`
/// without an HTTP request layer.
pub author_id: Option<ai_memory_core::UserId>,
+ /// Evidence sources backing this write (P2,
+ /// docs/design-hindsight-borrowings.md §3), forwarded verbatim to
+ /// [`ai_memory_core::NewPage::evidence`]. Populated by the
+ /// consolidator from the session(s) it drew on; empty for every
+ /// other caller (MCP tool, admin endpoints, lint rewriters).
+ pub evidence: Vec<ai_memory_core::PageEvidence>,
/// Identity carried in the on-disk frontmatter's `last_modified_by`
/// block AND the admission webhook payload's `ctx.actor`. The auth
/// middleware fills this from the four-rung resolution (injected as
@@ -2997,6 +3009,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
}
}
@@ -3117,6 +3130,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ActorContext::anonymous(),
+ evidence: Vec::new(),
})
};
@@ -4017,6 +4031,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.collect();
let ids = wiki.apply_batch(batch).await.unwrap();
@@ -4183,6 +4198,7 @@ mod tests {
}),
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
}])
.await
.unwrap();
@@ -4337,6 +4353,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -4353,6 +4370,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -4476,6 +4494,7 @@ mod tests {
}),
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -4626,6 +4645,7 @@ mod tests {
email: Some("[email protected]".into()),
..ai_memory_core::ActorContext::default()
},
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -4684,6 +4704,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -4769,6 +4790,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
};
// Many rounds so any interleave window is likely to be exercised.
@@ -4827,6 +4849,7 @@ mod tests {
admission_ctx: None,
author_id: None,
actor: ai_memory_core::ActorContext::anonymous(),
+ evidence: Vec::new(),
})
.await
.unwrap();
@@ -5588,6 +5611,7 @@ mod tests {
author_id: None,
expires_at: None,
entities: vec![],
+ evidence: Vec::new(),
})
.await
.unwrap();