@@ -5,6 +5,52 @@ All notable changes to the SochDB Python SDK will be documented in this file.
55The format is based on [ Keep a Changelog] ( https://keepachangelog.com/en/1.0.0/ ) ,
66and this project adheres to [ Semantic Versioning] ( https://semver.org/spec/v2.0.0.html ) .
77
8+ ## [ 0.4.5] - 2026-01-23
9+
10+ ### Added
11+
12+ #### LLM-Native Memory System
13+
14+ A complete memory management system for AI agents with FFI/gRPC dual-mode support:
15+
16+ ** Extraction Pipeline** (` sochdb.memory.extraction ` ):
17+ - ` Entity ` , ` Relation ` , ` Assertion ` typed intermediate representation
18+ - ` ExtractionSchema ` for validation with type constraints and confidence thresholds
19+ - ` ExtractionPipeline ` with atomic commits
20+ - Deterministic ID generation via content hashing
21+
22+ ** Event-Sourced Consolidation** (` sochdb.memory.consolidation ` ):
23+ - ` RawAssertion ` immutable events (append-only, never deleted)
24+ - ` CanonicalFact ` derived view (merged, deduplicated)
25+ - ` UnionFind ` clustering with O(α(n)) operations
26+ - Temporal interval updates for contradictions (not destructive edits)
27+ - Full provenance tracking with ` explain() ` method
28+
29+ ** Hybrid Retrieval** (` sochdb.memory.retrieval ` ):
30+ - ` AllowedSet ` for pre-filtering (security invariant: Results ⊆ allowed_set)
31+ - RRF fusion leveraging SochDB's built-in implementation
32+ - Optional cross-encoder reranking support
33+ - ` HybridRetriever ` with ` explain() ` for ranking debugging
34+
35+ ** Namespace Isolation** (` sochdb.memory.isolation ` ):
36+ - ` NamespaceId ` strongly-typed identifier with validation
37+ - ` ScopedQuery ` for type-level safety guarantees
38+ - ` NamespaceGrant ` for explicit, auditable cross-namespace access
39+ - ` ScopedNamespace ` with full audit logging
40+ - ` NamespaceManager ` for namespace lifecycle management
41+ - Policy modes: ` STRICT ` , ` EXPLICIT ` , ` AUDIT_ONLY `
42+
43+ All modules include:
44+ - FFI backend (embedded mode)
45+ - gRPC backend (server mode)
46+ - In-memory backend (testing)
47+ - Factory functions with auto-detection
48+
49+ ### Documentation
50+ - Added comprehensive Memory System section (Section 18) to README
51+ - Full API documentation with usage examples
52+ - Updated Table of Contents
53+
854## [ 0.2.3] - 2025-01-xx
955
1056### Fixed
0 commit comments