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.mdindex 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 workstreamsare 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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, patauthor_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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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, patauthor_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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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, boauthor_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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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, ProjectIadmission_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, ProjectIadmission_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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.sqlnew file mode 100644index 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.rsindex 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.rsindex 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.rsindex 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, anddiff --git a/crates/ai-memory-store/src/reader.rs b/crates/ai-memory-store/src/reader.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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.rsindex 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();