jordan 1ce4004807 feat: Complete Phase 2 (The Cortex) - query, lens, and API layers

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>

2026-02-01 13:22:44 -07:00

2.7 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
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 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.7 KiB Raw Blame History