1ce4004807
This commit adds the read path (Cortex) to complement the write path (Spine): ## Crates - stemedb-api: HTTP API with axum + utoipa OpenAPI - /v1/assert, /v1/query, /v1/epoch, /v1/skeptic, /v1/trace, /v1/audit - Metered endpoints with quota enforcement - Ed25519 signature verification - stemedb-lens: Truth resolution lenses - RecencyLens, ConsensusLens, ConfidenceLens - VoteAwareConsensusLens (Ballot Box pattern) - TrustAwareAuthorityLens (The Hive pattern) - SkepticLens (conflict analysis) - EpochAwareLens (paradigm-safe queries) - stemedb-query: Query engine with materialized views ## Storage Extensions - VoteStore: Vote aggregation with cached counts - TrustRankStore: Agent reputation with decay - AuditStore: Query audit trail - IndexStore: SP/P/S index structures - SupersessionStore: Epoch supersession chains ## SDKs - sdk/go/steme: Go HTTP client with Ed25519 signing - sdk/go/adk: ADK-Go tools for AI agents ## Documentation - Updated CLAUDE.md, architecture.md, roadmap.md - New ai-lookup entries for all services - Use case docs for consumer health intelligence - Arena roadmap for simulation advancement Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
46 lines
2.7 KiB
Markdown
46 lines
2.7 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 |
|
|
| Ballot Box | `services/ballot-box.md` | High | 2026-01-31 | High-velocity vote storage (VoteStore) |
|
|
| Ingestor | `services/ingestor.md` | High | 2026-01-31 | WAL-to-KV background worker |
|
|
| Lens | `services/lens.md` | High | 2026-01-31 | Read-time resolution strategies (includes TrustAwareAuthority) |
|
|
| Lifecycle | `services/lifecycle.md` | High | 2026-01-31 | Proposed/Approved state machine |
|
|
| Materializer | `services/materializer.md` | High | 2026-01-31 | Background worker for O(1) reads via MV: keys |
|
|
| API Surface | `services/api.md` | High | 2026-01-31 | HTTP API with axum + utoipa OpenAPI |
|
|
| SDK | `services/sdk.md` | High | 2026-02-01 | Go client libraries (core + ADK-Go integration) |
|
|
| Storage | `services/storage.md` | High | 2026-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 |
|
|
| API Documentation | `patterns/api-documentation.md` | High | 2026-01-31 | utoipa + OpenAPI + Slate DRY pipeline |
|
|
| 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/trust-rank.md` | High | 2026-01-31 | Agent reputation system with learning loop |
|
|
| 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 |
|