ae7d2ed8b1
Complete implementation of P5.5 Cluster Management Tooling with production-ready
stemedb-admin CLI tool for remote cluster operations.
## Features Implemented
### CLI Tool (1,200 lines)
- Cluster commands: health, status
- Node commands: list, info, shards
- Shard commands: list, info, replicas
- Debug commands: export
- Output formats: table (colored) and JSON
- Remote gateway connection via HTTP
### API Contract Fixes
- Handle gateway wrapper objects ({"ranges": [...]})
- Convert string shard IDs ("shard_0") to integers
- Normalize different endpoint formats (/v1/admin/ranges vs /v1/shards/:id)
- Custom deserializer for flexible ID formats
### Code Quality
- Zero clippy warnings (strict mode)
- Zero panics (unwrap/expect forbidden)
- 12 integration tests (all passing)
- Comprehensive error handling with anyhow
- Structured logging with tracing
### Documentation (7,000+ words)
- Node lifecycle operations guide (38 sections)
- CLI installation and usage guide (61 sections)
- Add/remove/replace node procedures
- Troubleshooting guides
## Testing
- Automated tests: 23/23 passing
- Cluster tests: 8/8 passing
- All commands verified against live 3-node cluster
## Production Readiness
- Code: Production-grade (0 warnings, defensive error handling)
- Tests: 31/31 passing (100%)
- Documentation: Complete operations guides
- Status: Ready for staging deployment
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
||
|---|---|---|
| .. | ||
| about | ||
| app-concepts | ||
| archive | ||
| demo/vulnbank | ||
| guides | ||
| legal | ||
| operations | ||
| presentations | ||
| references/go-adk | ||
| research | ||
| rfcs | ||
| sdk | ||
| specs | ||
| consistency-model.md | ||
| data-structures.md | ||
| README.md | ||
Episteme Documentation
Complete documentation for Episteme (StemeDB) - a probabilistic knowledge graph database.
Getting Started
First Steps
- Quick Start - Get running in 5 minutes
- What is Episteme? - Core concepts and examples
- Architecture Overview - Technical design
- Vision - Product philosophy
Use Cases
- Use Cases Index - All scenarios
- Consumer Health Intelligence - Drug safety tracking
- Financial Due Diligence - M&A analysis
- Agile Agent Team - AI collaboration
- GLP-1 Living Review - Real-world example
Application Development
Building on Episteme
- App Concepts Index - Application layer patterns
- Consumer Health Vertical - Healthcare application design
- Boundary Principles - What Episteme does vs. what your app does
SDKs & Integration
- Go SDK Guide - HTTP client with Ed25519 signing
- Go Usage Examples - Fluent builders and patterns
- ADK-Go Reference - AI agent integration
- ADK-Go Examples - Agent patterns (chatbot, researcher, etc.)
Technical References
Core Architecture
- Data Structures - Assertion, Vote, Epoch, MaterializedView
- Consistency Model - Conflict resolution and convergence
- Governance Models - Authority hierarchies
Advanced Topics
- Distributed Write Path - Clustering and sharding
- WAL Crash Recovery - Storage durability
- Concept Hierarchy - Subject/predicate organization
- Visual Hash Query - Screenshot-based retrieval
Specifications
- RFCs Index - All RFCs
- RFC-001: Enterprise Policy Aliases - Multi-tenant policy
Development Guides
Setting Up
- Local Development Setup - Environment configuration
- Testing Guide - Running test suites
- Quality Checks - Pre-commit hooks
- Coding Guidelines - Rust standards
How-To Guides
- Adding a Domain - Extend ontology for new verticals
- Implementation Audit Checklist - Production readiness
- Writing UAT Reports - User acceptance testing
Integration Guides
- AI Coding Assistant Integration - Claude/Cursor setup
- ADK-Go + Episteme - Building agents
Demos & Examples
- VulnBank Demo - Security vulnerability tracking example
Project Planning
Current Work
- Roadmap - Current and planned features
- Roadmap Archive - Completed phases
Specifications & Planning
- Aphoria Claims API - Claims management design
- Ontology Layer: Medical Vertical - Healthcare domain modeling
About Episteme
Vision & Strategy
- Market Position - Competitive landscape and thesis
- Simulation Vision - Agent-based validation
Legal
- Patent Disclosure - IP documentation
- Patent Figures - Visual diagrams
- Patent Specification - Technical claims
Tools & Infrastructure
- Grafana Dashboard - Metrics visualization
- Presentations - Slide decks and demos
Archive
Historical documentation and snapshots:
- Documentation Updates Summary - 2026-02-08 audit
- Corpus Quick Start - Legacy setup guide
Quick Reference: What Goes Where
| If you need to... | Episteme provides... | You build... |
|---|---|---|
| Store conflicting facts | Assertion type, append-only DAG | Nothing - just POST assertions |
| Resolve conflicts | Lenses (Recency, Consensus, Skeptic) | Lens selection logic |
| Query historical state | as_of parameter |
Time-travel UI |
| Track changes | since parameter + MV changelog |
Notification system |
| Weight by source authority | source_class field + decay |
Tier classifier |
| Detect emerging signals | Skeptic Lens + conflict_score | Gardener (threshold logic) |
| Show per-tier consensus | Layered Consensus Lens | Dashboard UI |
| Extract claims from papers | Nothing - pre-assertion transform | NLP pipeline |
| Sign assertions | Signature verification | Agent wallet / key management |
| Generate summaries | Structured query responses | LLM summarizer |
Contributing
See CONTRIBUTING.md for:
- Documentation standards
- File organization principles
- How to add new guides
- Review process
Navigation Tips
- Breadth-first: Start with What is Episteme? → Use Cases → Quick Start
- Depth-first: Start with Architecture → Data Structures → Distributed Write Path
- Hands-on: Start with Quick Start → Go SDK → App Concepts