How benjaminveysi/yowza works
Yowza is an offline-first persistent data engine with a C storage/database core and Go host. Its principal workflow accepts client operations through the daemon, authenticates them, applies writes through Raft when clustered, and serves reads from the database; its separate developer-mode workflow hosts a Wasm database behind a framework HTTP engine with cloud bootstrap. Query parsing, verified plans, the custom ISA, and the C execution engine form an internal query layer. The README documents WAL recovery, Timeline versioning, indexing, and optional clustering; several of those implementations were not sampled, so links without direct evidence are omitted.
Main entry points: segdb.h Layered SegDB · yowza/main.go Developer host · yowzad/main.go Authenticated daemon · query_isa.c Query ISA
Components 22
Applications and access
- CLI client
cmd/yowzactl/main.go - Authenticated daemon
cmd/yowzad/main.go - Developer host
cmd/yowza/main.go - Webhook framework
framework/framework.go
Query execution
- YowzaQL parser
query/parser.go - Query planner
query/engine.go - Query ISA
src/query_isa.c - ISA contract
include/query_isa.h - Wasm runtime
third_party_wazero64/runtime.go
Database and durability
- Go database host
yowza.go - Layered SegDB
include/segdb.h - C core interfaces
include - 64-bit object storage
src/storage2.c - WAL drivers
src/storage_memory.c - Timeline versioning
timeline.go
Clustering and integrations
- Cloud sync manager
cloud/manager.go - Cloud backends
cloud - Raft cluster
cluster/raft.go - Raft coordination
coord_coordinator.go - Service adapters
adapters
Other components
- API user
- External services
Connections 19
- API user → CLI client: issues commands
cmd/yowzactl/main.go - CLI client → Authenticated daemon: sends requests
cmd/yowzactl/main.go - Authenticated daemon → Go database host: reads values
cmd/yowzad/main.go - Authenticated daemon → Raft cluster: applies writes
- Developer host → Go database host: creates database
cmd/yowza/main.go - Developer host → Cloud sync manager: bootstraps sync
cmd/yowza/main.go - Developer host → Webhook framework: creates engine
cmd/yowza/main.go - Webhook framework → Cloud sync manager: uses manager
framework/framework.go - YowzaQL parser → Query planner: parses queries
- Query planner → Query ISA: compiles plans
- ISA contract → Query ISA: defines encoding
include/query_isa.h - Query ISA → Layered SegDB: executes against
src/query_isa.c - Go database host → Wasm runtime: runs Wasm
- Layered SegDB → 64-bit object storage: uses object store
- Layered SegDB → WAL drivers: persists WAL
- Layered SegDB → Timeline versioning: versions writes
- Cloud sync manager → Cloud backends: syncs state
- Raft cluster → Raft coordination: coordinates
- Service adapters → External services: connects optionally