stemedb/ai-lookup/index.md
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

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 |