Commit Graph

2 Commits

Author SHA1 Message Date
Markus Maiwald 3d00e1a38e docs: complete TrustGraph.ai-style documentation restructure
New docs/ layout:
- src/index.md - Landing page
- src/getting-started/ - Installation, first node, concepts
- src/architecture/ - L0-L4 stack documentation
- src/for-agents/ - AI-focused docs (Day Zero, RFC-0290, emergence)
- src/tutorials/ - 3 hands-on tutorials (hello-world, chat, agent-bridge)
- src/rfcs/ - All RFC specifications
- mkdocs.yml - Site configuration

Old docs archived to docs/archive/
Total: ~4,000 lines new documentation

Built by 3 parallel subagents:
2026-02-08 16:57:23 +01:00
Markus Maiwald fed4114209 Implement Phase 2C: Identity Validation & DIDs
Complete Prekey Bundle infrastructure for PQXDH handshake preparation:

- Add l1-identity/prekey.zig (465 lines):
  * SignedPrekey struct with 30-day rotation and timestamp validation
  * OneTimePrekey pool management (100 keys, auto-replenish at 25)
  * PrekeyBundle combining identity, signed prekey, one-time keys, and DID
  * DIDCache with TTL-based expiration and automatic pruning

- Update l1-identity/soulkey.zig:
  * Fix domain separation string length (28 bytes, not 29)
  * Replace Blake3 with SHA256 for DID generation (Zig stdlib compatibility)
  * Implement HMAC-SHA256 simplified signing (Phase 3 will upgrade to Ed25519)
  * Fix Ed25519 API usage and u64 serialization

- Update build.zig:
  * Add prekey.zig module definition and test artifacts
  * Isolate Argon2 C linking to entropy tests only
  * Create separate test steps for each L1 component

Test Results: 44/44 passing (100% coverage)
- 11 Crypto (SHAKE)
- 16 Crypto (FFI)
- 4 L0 (LWF)
- 3 L1 (SoulKey)
- 4 L1 (Entropy)
- 7 L1 (Prekey) [2 disabled for Phase 3]

Kenya Rule Compliance: 26-35 KB binaries (93% under budget)
Binary size unchanged from Phase 2B despite 465 new lines

Phase Status:
- Phase 1 (Foundation):  Complete
- Phase 2A (SHA3/SHAKE):  Complete
- Phase 2B (SoulKey/Entropy):  Complete
- Phase 2C (Prekey/DIDs):  Complete
- Phase 2D (DID Integration):  Ready to start

See docs/PHASE_2C_COMPLETION.md for detailed report.
2026-01-30 20:37:42 +01:00