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
3320c24afa
feat: WAL hardening (Phase 5B) - CRC32C, crash recovery, group commit, log rotation
...
Add CRC32C checksums to WAL record format (v2), implement crash recovery
with automatic truncation of corrupt records, add feature-gated group commit
buffer for batched fsync under concurrent load, and implement log rotation
via segment files with global offset addressing.
Key changes:
- Record format v2: [len:u32][crc32c:u32][blake3:32][payload:N]
- recover_file() scans and truncates corrupt tail records
- GroupCommitBuffer batches fsync via MPSC channel (tokio feature gate)
- SegmentManager with binary search resolution and cursor-based cleanup
- Journal::read() auto-refreshes segments on miss for writer/reader split
- Split recovery.rs and key_codec.rs into directory modules for 500-line max
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-02 12:36:35 -07: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
a776744889
Initial project setup with Claude Code monorepo structure
...
- Rust workspace with stemedb-core crate
- Full .claude/ configuration (agents, skills, commands, guides)
- ai-lookup/ for token-efficient fact storage
- Quality gates: clippy, fmt, jscpd duplication detection
- Pre-commit hook with 5-phase quality checks
- CLAUDE.md router and CODING_GUIDELINES.md standards
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-31 10:56:26 -07:00
