jordan 3cfaa1e1d3 feat: Complete Phase 1 (The Spine) - storage foundation

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>

2026-01-31 14:15:34 -07:00

2.1 KiB

Raw Blame History

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 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

2.1 KiB Raw Blame History