# Changelog

## [0.1.0] - 2026-05-18

首发版本 — 与 `cmdc` 主库 0.5.0 协同发布。

### Added

- **`CMDCMemoryPg.Repo`** — Ecto Repo for cmdc_memory_pg
- **`CMDCMemoryPg.CheckpointBackend`** — 实现 `CMDC.Checkpoint.Backend` 4 callback
  - snapshot 序列化走 `:erlang.term_to_binary(snap, [:compressed])` 写入 bytea
  - 复用 cmdc 主库 `CheckpointBackend.ETS` 同套测试 suite
- **`CMDCMemoryPg.EpisodicMemoryBackend`** — 实现 `CMDC.Memory` 5 callback
  - 与 cmdc 主库 `Plugin.Builtin.EpisodicMemory` 直接对接
  - 按 `user_id` namespace 隔离多租户
  - v0.1 `similarity_search/3` 降级为 ILIKE 文本匹配（pgvector 留 v0.2）
- Ecto migration 2 张表：`cmdc_checkpoints` + `cmdc_episodic_memories`
- `docker-compose.yml` — Postgres 16 alpine 测试用
- 完整 README + Cloak encryption 集成示例

### v0.1 范围说明（明确不含）

- ❌ pgvector 真语义检索（v0.2）
- ❌ 3-tier Memory（Working / Semantic / Procedural）— 留 v0.2
- ❌ Composite 路由 backend（cmdc 主库 `Backend.Composite`）
- ❌ KV jsonb backend（v0.2）
- ❌ Cloak encryption 强制集成（提供 `Snapshot.redact/2` hook 给集成方）

### Migration

新引入，无 migration。配置 + `mix ecto.migrate` 即可使用。