How g-man3207/kronik works
Kronik records deterministic actor turns and their effects, then lets operators fork the recorded history, replay proposed code, inspect behavior diffs, and promote or roll back changes. The graph follows the documented request-to-durable-turn and proposal-to-review workflows, with branches for privacy, blobs, foreign actors, and operations. Many implementation links are documented only at product level; unsampled internals are represented conservatively, and their edges cite the README.
Main entry points: turn.rs Turn Execution · main.rs CLI · manager.rs Foreign Actors · node.rs Turn Scheduler
Components 24
User Interfaces
- CLI
crates/kronik/src/main.rs - JSON API
crates/kronik-api/src/server.rs - HTTP Gateway
crates/kronik-gateway/src/server.rs - Authentication
crates/kronik-api/src/auth.rs - Bearer Tokens
crates/kronik-api/src/tokens.rs
Turn Execution
- Turn Scheduler
crates/kronik-sched/src/node.rs - Wasm Runtime
crates/kronik-runtime/src/engine.rs - Turn Execution
crates/kronik-runtime/src/turn.rs - Effect Handling
crates/kronik-effects/src/http.rs - Append-only Log
crates/kronik-log/src/lib.rs - State and SQL
crates/kronik-store/src/db.rs
Change Review
- Fork and Replay
crates/kronik-fork/src/replay.rs - Behavior Diff
crates/kronik-fork/src/diff.rs - Change Policy
crates/kronik-policy/src/lib.rs
Operations and Extensions
- Blob Storage
crates/kronik-blob/src/store.rs - Privacy Controls
crates/kronik-privacy/src/lib.rs - Foreign Actors
crates/kronik-foreign/src/manager.rs - Foreign Runtime
crates/kronik-foreign/src/runtime.rs - Foreign Bridge
crates/kronik-foreign/src/bridge.rs - MicroVM Backend
crates/kronik-foreign/src/microvm.rs - Foreign Support
crates/kronik-foreign/src - Telemetry and Audit
crates/kronik-otel/src/follow.rs - Fleet Enrollment
crates/kronik-fleet/src/enrollment.rs
Other components
- Operator or Client
Connections 27
- Operator or Client → CLI: runs commands
README.md - Operator or Client → HTTP Gateway: sends requests
README.md - Operator or Client → JSON API: uses API
README.md - CLI → JSON API: issues operations
README.md - JSON API → Authentication: resolves caller
crates/kronik-api/src/server.rs - Authentication → Bearer Tokens: resolves bearer
crates/kronik-api/src/auth.rs - HTTP Gateway → Turn Scheduler: admits turns
README.md - JSON API → Turn Scheduler: admits turns
README.md - Turn Scheduler → Wasm Runtime: runs actors
README.md - Wasm Runtime → Turn Execution: executes handler
crates/kronik-runtime/src/engine.rs - Turn Execution → Effect Handling: requests effects
README.md - Turn Execution → Append-only Log: records turn
README.md - Turn Scheduler → State and SQL: applies records
README.md - CLI → Fork and Replay: starts proposal
README.md - Fork and Replay → Append-only Log: replays history
README.md - Fork and Replay → Behavior Diff: compares behavior
README.md - Fork and Replay → Change Policy: checks change
README.md - CLI → Blob Storage: manages blobs
README.md - Turn Execution → Blob Storage: streams blob data
README.md - Turn Execution → Privacy Controls: seals subject data
README.md - Turn Scheduler → Foreign Actors: reconciles actors
crates/kronik-foreign/src/manager.rs - Foreign Actors → Foreign Runtime: manages runtime
crates/kronik-foreign/src/manager.rs - Foreign Actors → Foreign Bridge: serves bridge
crates/kronik-foreign/src/manager.rs - Foreign Actors → MicroVM Backend: uses backend
crates/kronik-foreign/src/manager.rs - Foreign Actors → Foreign Support: uses support modules
crates/kronik-foreign/src/manager.rs - Turn Execution → Telemetry and Audit: exports telemetry
README.md - CLI → Fleet Enrollment: manages enrollment