jml
9bfa626203
docs: reorganize documentation structure for clarity
...
Major documentation restructure to improve discoverability and reduce duplication.
## Changes
**Deleted (Archived/Consolidated)**:
- Removed duplicate getting started guides
- Archived outdated planning documents
- Consolidated corpus and configuration docs
- Removed obsolete vision/spec files (superseded by vision.md)
- Cleaned up scrapyard and old PDFs
**New Structure**:
- docs/about/ - Project overview and introduction
- docs/guides/ - User guides (moved from root)
- docs/specs/ - Technical specifications
- docs/sdk/ - SDK documentation (Go)
- docs/references/ - API references
- docs/archive/ - Archived historical docs
- applications/aphoria/docs/advanced/ - Advanced topics
- applications/aphoria/docs/reference/ - CLI reference
- applications/aphoria/docs/archive/ - Archived aphoria docs
**Updated**:
- README.md - New root README with clear navigation
- CONTRIBUTING.md - Contribution guidelines
- CLAUDE.md - Updated paths to new structure
- roadmap.md - Added recent completions
## Files Changed
- 57 files changed
- 1,977 insertions(+)
- 961 deletions(-)
**Net change**: +1,016 lines (added CONTRIBUTING.md, README.md, reorganized content)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-11 07:33:40 +00:00
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
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
