cel-memory 0.2.1

Backend-agnostic memory traits and value types for AI agents, with scoped retrieval, sessions, and governance hooks.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

# Changelog

All notable changes to `cel-memory` will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

Pre-1.0 releases were developed privately before the first public crates.io
line at `0.1.5`.

## [Unreleased]

## [0.2.1] — 2026-06-25

### Added
- [`assert_retrieve_finds_written`], [`assert_session_lifecycle`], and
  [`assert_summarize_session_roundtrip`] conformance helpers for backend
  integration tests.

[`assert_retrieve_finds_written`]: https://docs.rs/cel-memory/latest/cel_memory/fn.assert_retrieve_finds_written.html
[`assert_session_lifecycle`]: https://docs.rs/cel-memory/latest/cel_memory/fn.assert_session_lifecycle.html
[`assert_summarize_session_roundtrip`]: https://docs.rs/cel-memory/latest/cel_memory/fn.assert_summarize_session_roundtrip.html

## [0.2.0] — 2026-06-25

### Added
- [`Embedder`] trait, [`EmbedderError`], and [`MockEmbedder`] — extracted from
  `cel-memory-sqlite` so backends depend on the contract crate only.
- [`assert_write_get_stats`] conformance helper for backend integration tests.

### Changed
- **Breaking:** removed the deprecated `ChunkSource::Cortex` alias; use
  `ChunkSource::Perception`.
- MSRV raised to **1.76** (`rust-version` in `Cargo.toml`).

[`Embedder`]: https://docs.rs/cel-memory/latest/cel_memory/trait.Embedder.html
[`EmbedderError`]: https://docs.rs/cel-memory/latest/cel_memory/enum.EmbedderError.html
[`MockEmbedder`]: https://docs.rs/cel-memory/latest/cel_memory/struct.MockEmbedder.html
[`assert_write_get_stats`]: https://docs.rs/cel-memory/latest/cel_memory/fn.assert_write_get_stats.html

## [0.1.9] — 2026-06-25

### Added
- [`BACKENDS.md`](BACKENDS.md) on crates.io — community guide for custom
  `MemoryProvider` storage engines (PostgreSQL, DuckDB, etc.) in separate crates.

## [0.1.8] — 2026-06-25

### Added
- `BasicMemoryProvider::with_summarizer` and in-memory implementations of
  `summarize_session`, `rollup_day`, `rollup_rule_week`, and `re_embed_all`.

## [0.1.7] — 2026-06-25

### Changed
- Added crates.io metadata, README badges, and Clippy in CI.
- Removed orphan MIT license file; Apache-2.0 only.

## [0.1.6] — 2026-06-25

### Added
- Standalone GitHub repository at `https://github.com/dimpagk92/cel-memory`.
- Additional examples: `backend_swap`, `write_hook`, and `custom_provider`.

### Changed
- Renamed `ChunkSource::Cortex` to `ChunkSource::Perception` (deprecated alias retained).
- Published as a standalone crate on crates.io.

## [0.1.0-pre] — 2026-05-23

### Added
- `MemoryProvider` trait — the locked contract between memory backends and
  callers (agents, CLIs, servers, apps, test harnesses).
- Value types: `MemoryChunk`, `NewMemoryChunk`, `ChunkKind`, `ChunkSource`,
  `MemoryTier`, `MemorySession`, `NewMemorySession`, `SessionOutcome`,
  `MemoryQuery`, `MemoryPredicate`, `RetrievalProfile`, `CallerScope`.
- `BasicMemoryProvider` — in-process reference implementation. Useful for
  tests and as a documentation of the trait contract.
- `MemoryWriteHook` trait — governance seam consulted before every write.
  Lets a rule engine redact or veto persistence without coupling the
  memory provider to a specific rule format.
- `MemoryError` — self-contained `thiserror` enum. No runtime-specific
  re-exports.
- `examples/basic.rs` — runnable end-to-end example using
  `BasicMemoryProvider`. Builds with only this crate's declared deps.

### Notes
- Public API exposes no runtime-domain types. Future PRs may break the trait
  during the `0.1.0-pre` series; the trait stabilizes at `0.1.0`.