📚 Technical Reference Overview
The Technical Reference section provides ground-truth specifications, data models, design tokens, and compliance documentation for developers, system administrators, and security auditors interacting with the ShellGuard ecosystem.
🧭 Reference Guides
Database Schema Ground Truth
Database Complete SQLite schema definitions for
lobsters, vault_pearls, agent_keys, attachments, and audit tables. Reef Modernist Design System
Design Design philosophy, bioluminescent color tokens, dynamic theme palettes, typography, and motion physics.
ClawStack Lexicon (Glossary)
Terminology Authoritative definitions for all ecosystem terminology: Pearls, Pods, Lobsters, LobsterKeys, and ShellCryption.
ShellGuard-TOTP Companion
Mobile Complete architecture, security, backup, and RFC 6238 TOTP engine specifications for the native Android companion.
Official Privacy Policy
Compliance Comprehensive legal and regulatory disclosures, Google Play Store compliance, and zero-telemetry guarantees.
🔒 Architectural Invariants at a Glance
| Invariant | Implementation | Boundary |
|---|---|---|
| Zero-Knowledge Core | Client-side HKDF-SHA256 + AES-GCM-256 with AAD binding | Plaintext keys and secrets never leave the user's browser or device. |
| Three Secrets Model | hu- (ClawKey), lb- (LobsterKey), SENSITIVE_KEY (Server Master) | Strict operational segregation between humans, AI agents, and server storage. |
| Triple-Layer Defense | Layer 1: Client ShellCryption Layer 2: Metadata AES-256-GCM Layer 3: SQLCipher Whole-DB | Defense-in-depth against physical database theft and server-side compromise. |
| Forensic Segregation | Append-only audit.sqlite separate from db.sqlite | Audit logs cannot be modified, deleted, or wiped by database restores. |
| Offline-First Companion | Hardware KeyStore + StrongBox enclave on Android | Generates 2FA codes 100% offline without network requests or external tracking. |