Phase 1 delivers the complete durability and storage layer:
- WAL with crash recovery: Append-only journal with BLAKE3 checksums,
fsync guarantees, and proper seek-to-EOF on reopen
- Storage engine: sled-backed KVStore with scan_prefix for range queries
- Content-addressed storage: H:{hash}, V:{hash}, E:{hash} key patterns
- Ingestor: Background worker tailing WAL, writing to KV with 8-byte
aligned record headers for rkyv zero-copy deserialization
- Comprehensive tests: 31 tests covering crash recovery, round-trips,
and multi-cycle durability
New crates: stemedb-wal, stemedb-storage, stemedb-ingest
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
41 lines
2.1 KiB
Markdown
41 lines
2.1 KiB
Markdown
# AI Lookup Index
|
|
|
|
Token-efficient fact storage for StemeDB. Query these for quick context without loading full docs.
|
|
|
|
## Services
|
|
|
|
| Topic | File | Confidence | Updated | Summary |
|
|
|-------|------|------------|---------|---------|
|
|
| Assertion | `services/assertion.md` | High | 2025-01-31 | Core data structure for all claims |
|
|
| Ingestor | `services/ingestor.md` | High | 2026-01-31 | WAL-to-KV background worker |
|
|
| Lens | `services/lens.md` | High | 2025-01-31 | Read-time resolution strategies |
|
|
| Lifecycle | `services/lifecycle.md` | High | 2026-01-31 | Proposed/Approved state machine |
|
|
| Storage | `services/storage.md` | High | 2025-01-31 | KV layout and write path |
|
|
|
|
## Patterns
|
|
|
|
| Topic | File | Confidence | Updated | Summary |
|
|
|-------|------|------------|---------|---------|
|
|
| ADK-Go Integration | `patterns/adk-integration.md` | High | 2026-01-31 | Tool definitions and callbacks for agents |
|
|
| Content-Addressing | `patterns/content-addressing.md` | High | 2025-01-31 | BLAKE3 hashing for immutability |
|
|
| Error Handling | `patterns/error-handling.md` | High | 2025-01-31 | thiserror + context pattern |
|
|
|
|
## Features
|
|
|
|
| Topic | File | Confidence | Updated | Summary |
|
|
|-------|------|------------|---------|---------|
|
|
| Branching | `features/branching.md` | Medium | 2025-01-31 | "Fork Reality" overlay graphs |
|
|
| Gardener | `features/gardener.md` | High | 2026-01-31 | TrustRank back-propagation on errors |
|
|
| Query Audit | `features/query-audit.md` | High | 2026-01-31 | Trace agent decisions for debugging |
|
|
| TrustRank | `features/trustrank.md` | Medium | 2025-01-31 | Agent reputation system |
|
|
| Simulation | `features/simulation.md` | High | 2026-01-31 | Agent-based modeling for validation |
|
|
|
|
## Use Cases
|
|
|
|
See [use-cases/README.md](../use-cases/README.md) for production scenarios with Postgres Test analysis.
|
|
|
|
| Use Case | File | Pillars | Summary |
|
|
|----------|------|---------|---------|
|
|
| Financial Due Diligence | `../use-cases/financial-due-diligence.md` | All Four | M&A investigation with contradictions |
|
|
| Agile AI Agent Team | `../use-cases/agile-agent-team.md` | All Four | Agent coordination with lifecycle stages |
|