# g-man3207/kronik architecture

> Architecture diagram of the GitHub repository g-man3207/kronik, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/g-man3207/kronik
- Repository: https://github.com/g-man3207/kronik

## Overview

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: [`crates/kronik-runtime/src/turn.rs`](https://github.com/g-man3207/kronik/blob/main/crates/kronik-runtime/src/turn.rs) (Turn Execution), [`crates/kronik/src/main.rs`](https://github.com/g-man3207/kronik/blob/main/crates/kronik/src/main.rs) (CLI), [`crates/kronik-foreign/src/manager.rs`](https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/manager.rs) (Foreign Actors), [`crates/kronik-sched/src/node.rs`](https://github.com/g-man3207/kronik/blob/main/crates/kronik-sched/src/node.rs) (Turn Scheduler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["CLI<br/>[main.rs]"]
  node_api["JSON API<br/>[server.rs]"]
  node_gateway["HTTP Gateway<br/>[server.rs]"]
  node_auth["Authentication<br/>[auth.rs]"]
  node_tokens[("Bearer Tokens<br/>[tokens.rs]")]
end

subgraph group_execution["Turn Execution"]
  node_scheduler["Turn Scheduler<br/>[node.rs]"]
  node_runtime["Wasm Runtime<br/>[engine.rs]"]
  node_turn["Turn Execution<br/>[turn.rs]"]
  node_effects["Effect Handling<br/>[http.rs]"]
  node_log[("Append-only Log<br/>[lib.rs]")]
  node_store[("State and SQL<br/>[db.rs]")]
end

subgraph group_change["Change Review"]
  node_proposal["Fork and Replay<br/>[replay.rs]"]
  node_diff["Behavior Diff<br/>[diff.rs]"]
  node_policy["Change Policy<br/>[lib.rs]"]
end

subgraph group_operations["Operations and Extensions"]
  node_blob[("Blob Storage<br/>[store.rs]")]
  node_privacy["Privacy Controls<br/>[lib.rs]"]
  node_foreign["Foreign Actors<br/>[manager.rs]"]
  node_foreign_runtime["Foreign Runtime<br/>[runtime.rs]"]
  node_foreign_bridge["Foreign Bridge<br/>[bridge.rs]"]
  node_microvm["MicroVM Backend<br/>[microvm.rs]"]
  node_foreign_support["Foreign Support"]
  node_observability["Telemetry and Audit<br/>[follow.rs]"]
  node_fleet["Fleet Enrollment<br/>[enrollment.rs]"]
end

node_operator(("Operator or Client"))

node_operator -->|"runs commands"| node_cli
node_operator -->|"sends requests"| node_gateway
node_operator -->|"uses API"| node_api
node_cli -->|"issues operations"| node_api
node_api -->|"resolves caller"| node_auth
node_auth -->|"resolves bearer"| node_tokens
node_gateway -->|"admits turns"| node_scheduler
node_api -->|"admits turns"| node_scheduler
node_scheduler -->|"runs actors"| node_runtime
node_runtime -->|"executes handler"| node_turn
node_turn -->|"requests effects"| node_effects
node_turn -->|"records turn"| node_log
node_scheduler -->|"applies records"| node_store
node_cli -->|"starts proposal"| node_proposal
node_proposal -->|"replays history"| node_log
node_proposal -->|"compares behavior"| node_diff
node_proposal -->|"checks change"| node_policy
node_cli -->|"manages blobs"| node_blob
node_turn -->|"streams blob data"| node_blob
node_turn -->|"seals subject data"| node_privacy
node_scheduler -->|"reconciles actors"| node_foreign
node_foreign -->|"manages runtime"| node_foreign_runtime
node_foreign -->|"serves bridge"| node_foreign_bridge
node_foreign -->|"uses backend"| node_microvm
node_foreign -.->|"uses support modules"| node_foreign_support
node_turn -->|"exports telemetry"| node_observability
node_cli -.->|"manages enrollment"| node_fleet

click node_cli "https://github.com/g-man3207/kronik/blob/main/crates/kronik/src/main.rs"
click node_api "https://github.com/g-man3207/kronik/blob/main/crates/kronik-api/src/server.rs"
click node_gateway "https://github.com/g-man3207/kronik/blob/main/crates/kronik-gateway/src/server.rs"
click node_auth "https://github.com/g-man3207/kronik/blob/main/crates/kronik-api/src/auth.rs"
click node_tokens "https://github.com/g-man3207/kronik/blob/main/crates/kronik-api/src/tokens.rs"
click node_scheduler "https://github.com/g-man3207/kronik/blob/main/crates/kronik-sched/src/node.rs"
click node_runtime "https://github.com/g-man3207/kronik/blob/main/crates/kronik-runtime/src/engine.rs"
click node_turn "https://github.com/g-man3207/kronik/blob/main/crates/kronik-runtime/src/turn.rs"
click node_effects "https://github.com/g-man3207/kronik/blob/main/crates/kronik-effects/src/http.rs"
click node_log "https://github.com/g-man3207/kronik/blob/main/crates/kronik-log/src/lib.rs"
click node_store "https://github.com/g-man3207/kronik/blob/main/crates/kronik-store/src/db.rs"
click node_proposal "https://github.com/g-man3207/kronik/blob/main/crates/kronik-fork/src/replay.rs"
click node_diff "https://github.com/g-man3207/kronik/blob/main/crates/kronik-fork/src/diff.rs"
click node_policy "https://github.com/g-man3207/kronik/blob/main/crates/kronik-policy/src/lib.rs"
click node_blob "https://github.com/g-man3207/kronik/blob/main/crates/kronik-blob/src/store.rs"
click node_privacy "https://github.com/g-man3207/kronik/blob/main/crates/kronik-privacy/src/lib.rs"
click node_foreign "https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/manager.rs"
click node_foreign_runtime "https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/runtime.rs"
click node_foreign_bridge "https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/bridge.rs"
click node_microvm "https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/microvm.rs"
click node_foreign_support "https://github.com/g-man3207/kronik/tree/main/crates/kronik-foreign/src"
click node_observability "https://github.com/g-man3207/kronik/blob/main/crates/kronik-otel/src/follow.rs"
click node_fleet "https://github.com/g-man3207/kronik/blob/main/crates/kronik-fleet/src/enrollment.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_api,node_gateway,node_auth,node_tokens,node_operator toneBlue
class node_scheduler,node_runtime,node_turn,node_effects,node_log,node_store toneAmber
class node_proposal,node_diff,node_policy toneMint
class node_blob,node_privacy,node_foreign,node_foreign_runtime,node_foreign_bridge,node_microvm,node_foreign_support,node_observability,node_fleet toneRose
```

## Components

### User Interfaces

- [CLI](https://github.com/g-man3207/kronik/blob/main/crates/kronik/src/main.rs): `crates/kronik/src/main.rs`
- [JSON API](https://github.com/g-man3207/kronik/blob/main/crates/kronik-api/src/server.rs): `crates/kronik-api/src/server.rs`
- [HTTP Gateway](https://github.com/g-man3207/kronik/blob/main/crates/kronik-gateway/src/server.rs): `crates/kronik-gateway/src/server.rs`
- [Authentication](https://github.com/g-man3207/kronik/blob/main/crates/kronik-api/src/auth.rs): `crates/kronik-api/src/auth.rs`
- [Bearer Tokens](https://github.com/g-man3207/kronik/blob/main/crates/kronik-api/src/tokens.rs): `crates/kronik-api/src/tokens.rs`

### Turn Execution

- [Turn Scheduler](https://github.com/g-man3207/kronik/blob/main/crates/kronik-sched/src/node.rs): `crates/kronik-sched/src/node.rs`
- [Wasm Runtime](https://github.com/g-man3207/kronik/blob/main/crates/kronik-runtime/src/engine.rs): `crates/kronik-runtime/src/engine.rs`
- [Turn Execution](https://github.com/g-man3207/kronik/blob/main/crates/kronik-runtime/src/turn.rs): `crates/kronik-runtime/src/turn.rs`
- [Effect Handling](https://github.com/g-man3207/kronik/blob/main/crates/kronik-effects/src/http.rs): `crates/kronik-effects/src/http.rs`
- [Append-only Log](https://github.com/g-man3207/kronik/blob/main/crates/kronik-log/src/lib.rs): `crates/kronik-log/src/lib.rs`
- [State and SQL](https://github.com/g-man3207/kronik/blob/main/crates/kronik-store/src/db.rs): `crates/kronik-store/src/db.rs`

### Change Review

- [Fork and Replay](https://github.com/g-man3207/kronik/blob/main/crates/kronik-fork/src/replay.rs): `crates/kronik-fork/src/replay.rs`
- [Behavior Diff](https://github.com/g-man3207/kronik/blob/main/crates/kronik-fork/src/diff.rs): `crates/kronik-fork/src/diff.rs`
- [Change Policy](https://github.com/g-man3207/kronik/blob/main/crates/kronik-policy/src/lib.rs): `crates/kronik-policy/src/lib.rs`

### Operations and Extensions

- [Blob Storage](https://github.com/g-man3207/kronik/blob/main/crates/kronik-blob/src/store.rs): `crates/kronik-blob/src/store.rs`
- [Privacy Controls](https://github.com/g-man3207/kronik/blob/main/crates/kronik-privacy/src/lib.rs): `crates/kronik-privacy/src/lib.rs`
- [Foreign Actors](https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/manager.rs): `crates/kronik-foreign/src/manager.rs`
- [Foreign Runtime](https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/runtime.rs): `crates/kronik-foreign/src/runtime.rs`
- [Foreign Bridge](https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/bridge.rs): `crates/kronik-foreign/src/bridge.rs`
- [MicroVM Backend](https://github.com/g-man3207/kronik/blob/main/crates/kronik-foreign/src/microvm.rs): `crates/kronik-foreign/src/microvm.rs`
- [Foreign Support](https://github.com/g-man3207/kronik/tree/main/crates/kronik-foreign/src): `crates/kronik-foreign/src`
- [Telemetry and Audit](https://github.com/g-man3207/kronik/blob/main/crates/kronik-otel/src/follow.rs): `crates/kronik-otel/src/follow.rs`
- [Fleet Enrollment](https://github.com/g-man3207/kronik/blob/main/crates/kronik-fleet/src/enrollment.rs): `crates/kronik-fleet/src/enrollment.rs`

### Other components

- **Operator or Client**

## Connections

- Operator or Client → CLI: runs commands (evidence: `README.md`)
- Operator or Client → HTTP Gateway: sends requests (evidence: `README.md`)
- Operator or Client → JSON API: uses API (evidence: `README.md`)
- CLI → JSON API: issues operations (evidence: `README.md`)
- JSON API → Authentication: resolves caller (evidence: `crates/kronik-api/src/server.rs`)
- Authentication → Bearer Tokens: resolves bearer (evidence: `crates/kronik-api/src/auth.rs`)
- HTTP Gateway → Turn Scheduler: admits turns (evidence: `README.md`)
- JSON API → Turn Scheduler: admits turns (evidence: `README.md`)
- Turn Scheduler → Wasm Runtime: runs actors (evidence: `README.md`)
- Wasm Runtime → Turn Execution: executes handler (evidence: `crates/kronik-runtime/src/engine.rs`)
- Turn Execution → Effect Handling: requests effects (evidence: `README.md`)
- Turn Execution → Append-only Log: records turn (evidence: `README.md`)
- Turn Scheduler → State and SQL: applies records (evidence: `README.md`)
- CLI → Fork and Replay: starts proposal (evidence: `README.md`)
- Fork and Replay → Append-only Log: replays history (evidence: `README.md`)
- Fork and Replay → Behavior Diff: compares behavior (evidence: `README.md`)
- Fork and Replay → Change Policy: checks change (evidence: `README.md`)
- CLI → Blob Storage: manages blobs (evidence: `README.md`)
- Turn Execution → Blob Storage: streams blob data (evidence: `README.md`)
- Turn Execution → Privacy Controls: seals subject data (evidence: `README.md`)
- Turn Scheduler → Foreign Actors: reconciles actors (evidence: `crates/kronik-foreign/src/manager.rs`)
- Foreign Actors → Foreign Runtime: manages runtime (evidence: `crates/kronik-foreign/src/manager.rs`)
- Foreign Actors → Foreign Bridge: serves bridge (evidence: `crates/kronik-foreign/src/manager.rs`)
- Foreign Actors → MicroVM Backend: uses backend (evidence: `crates/kronik-foreign/src/manager.rs`)
- Foreign Actors → Foreign Support: uses support modules (evidence: `crates/kronik-foreign/src/manager.rs`)
- Turn Execution → Telemetry and Audit: exports telemetry (evidence: `README.md`)
- CLI → Fleet Enrollment: manages enrollment
