Skip to content

Commit eb4c4ec

Browse files
committed
release(0.4.5): Add Memory System documentation and bump version
1 parent 60ecb33 commit eb4c4ec

3 files changed

Lines changed: 424 additions & 41 deletions

File tree

CHANGELOG.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,52 @@ All notable changes to the SochDB Python SDK will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
66
and 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

Comments
 (0)