# kadircanyildirm-crypto/wardyn architecture

> Architecture diagram of the GitHub repository kadircanyildirm-crypto/wardyn, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kadircanyildirm-crypto/wardyn
- Repository: https://github.com/kadircanyildirm-crypto/wardyn

## Overview

Wardyn launches and watches a command’s process subtree, evaluates its policy, and observes or denies file, exec, and network operations at kernel hooks. The userspace runner also applies Landlock containment, presents events live, writes an audit log, and gives the agent denial receipts. Stored approvals extend operator decisions across runs. The README documents these capabilities; several internal calls and data paths are not visible in the sampled excerpts, so uncertain links are omitted.

Main entry points: [`wardyn/src/main.rs`](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/main.rs) (Run orchestrator), [`wardyn-ebpf/src/main.rs`](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-ebpf/src/main.rs) (eBPF hooks), [`wardyn/src/tui.rs`](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/tui.rs) (Live event UI), [`wardyn-policy/src/policy.rs`](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/policy.rs) (Policy engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Run control"]
  node_runner["Run orchestrator<br/>[main.rs]"]
  node_argparser["CLI parser<br/>[cli.rs]"]
end

subgraph group_rules["Policy and approvals"]
  node_policy["Policy engine<br/>[policy.rs]"]
  node_identity["Identity rules<br/>[identity.rs]"]
  node_approval["Approval store<br/>[overrides.rs]"]
  node_approvalfile["Approval file<br/>[overrides_file.rs]"]
end

subgraph group_kernel["Kernel enforcement"]
  node_bpfloader["Hook loader<br/>[hook.rs]"]
  node_btf["BTF resolver<br/>[btf.rs]"]
  node_ebpf["eBPF hooks<br/>[main.rs]"]
  node_landlock["Landlock rules<br/>[landlock.rs]"]
end

subgraph group_outputs["Events and outputs"]
  node_common["Event definitions<br/>[lib.rs]"]
  node_audit["Audit writer<br/>[audit.rs]"]
  node_tui["Live event UI<br/>[tui.rs]"]
  node_receipt["Denial receipt<br/>[receipt.rs]"]
  node_auditfile["JSONL audit file"]
end

node_operator(("Operator"))
node_agent["Agent command"]

node_operator -->|"launches"| node_runner
node_runner -->|"parses options"| node_argparser
node_agent -->|"runs under watch"| node_runner
node_runner -->|"loads policy"| node_policy
node_policy -->|"resolves identities"| node_identity
node_runner -->|"loads approvals"| node_approvalfile
node_approvalfile -->|"parses and saves"| node_approval
node_runner -->|"sets up hooks"| node_bpfloader
node_runner -->|"resolves offsets"| node_btf
node_runner -->|"applies containment"| node_landlock
node_ebpf -->|"observes or denies"| node_agent
node_runner -.->|"loads kernel programs"| node_ebpf
node_ebpf -.->|"emits events"| node_common
node_runner -.->|"consumes events"| node_common
node_runner -->|"records decisions"| node_audit
node_audit -->|"writes JSONL"| node_auditfile
node_runner -->|"shows live feed"| node_tui
node_runner -->|"records denials"| node_receipt
node_receipt -->|"exposes denial details"| node_agent
node_operator -->|"reviews events"| node_tui
node_tui -.->|"requests exception"| node_runner

click node_runner "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/main.rs"
click node_argparser "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/cli.rs"
click node_policy "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/policy.rs"
click node_identity "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/identity.rs"
click node_approval "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/overrides.rs"
click node_approvalfile "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/overrides_file.rs"
click node_bpfloader "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/hook.rs"
click node_btf "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/btf.rs"
click node_ebpf "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-ebpf/src/main.rs"
click node_landlock "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/landlock.rs"
click node_common "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-common/src/lib.rs"
click node_audit "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/audit.rs"
click node_tui "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/tui.rs"
click node_receipt "https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/receipt.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_runner,node_argparser toneBlue
class node_policy,node_identity,node_approval,node_approvalfile toneAmber
class node_bpfloader,node_btf,node_ebpf,node_landlock toneMint
class node_common,node_audit,node_tui,node_receipt,node_auditfile toneRose
class node_operator,node_agent toneIndigo
```

## Components

### Run control

- [Run orchestrator](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/main.rs): `wardyn/src/main.rs`
- [CLI parser](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/cli.rs): `wardyn-policy/src/cli.rs`

### Policy and approvals

- [Policy engine](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/policy.rs): `wardyn-policy/src/policy.rs`
- [Identity rules](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/identity.rs): `wardyn-policy/src/identity.rs`
- [Approval store](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-policy/src/overrides.rs): `wardyn-policy/src/overrides.rs`
- [Approval file](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/overrides_file.rs): `wardyn/src/overrides_file.rs`

### Kernel enforcement

- [Hook loader](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/hook.rs): `wardyn/src/hook.rs`
- [BTF resolver](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/btf.rs): `wardyn/src/btf.rs`
- [eBPF hooks](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-ebpf/src/main.rs): `wardyn-ebpf/src/main.rs`
- [Landlock rules](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/landlock.rs): `wardyn/src/landlock.rs`

### Events and outputs

- [Event definitions](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn-common/src/lib.rs): `wardyn-common/src/lib.rs`
- [Audit writer](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/audit.rs): `wardyn/src/audit.rs`
- [Live event UI](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/tui.rs): `wardyn/src/tui.rs`
- [Denial receipt](https://github.com/kadircanyildirm-crypto/wardyn/blob/main/wardyn/src/receipt.rs): `wardyn/src/receipt.rs`
- **JSONL audit file**

### Other components

- **Operator**
- **Agent command**

## Connections

- Operator → Run orchestrator: launches (evidence: `README.md`)
- Run orchestrator → CLI parser: parses options (evidence: `wardyn/src/main.rs`)
- Agent command → Run orchestrator: runs under watch (evidence: `README.md`)
- Run orchestrator → Policy engine: loads policy (evidence: `wardyn/src/main.rs`)
- Policy engine → Identity rules: resolves identities (evidence: `wardyn-policy/src/identity.rs`)
- Run orchestrator → Approval file: loads approvals (evidence: `wardyn/src/overrides_file.rs`)
- Approval file → Approval store: parses and saves (evidence: `wardyn/src/overrides_file.rs`)
- Run orchestrator → Hook loader: sets up hooks (evidence: `wardyn/src/main.rs`)
- Run orchestrator → BTF resolver: resolves offsets (evidence: `wardyn/src/btf.rs`)
- Run orchestrator → Landlock rules: applies containment (evidence: `wardyn/src/landlock.rs`)
- eBPF hooks → Agent command: observes or denies (evidence: `README.md`)
- Run orchestrator → eBPF hooks: loads kernel programs
- eBPF hooks → Event definitions: emits events
- Run orchestrator → Event definitions: consumes events
- Run orchestrator → Audit writer: records decisions (evidence: `README.md`)
- Audit writer → JSONL audit file: writes JSONL (evidence: `README.md`)
- Run orchestrator → Live event UI: shows live feed (evidence: `wardyn/src/main.rs`)
- Run orchestrator → Denial receipt: records denials (evidence: `wardyn/src/main.rs`)
- Denial receipt → Agent command: exposes denial details (evidence: `wardyn/src/receipt.rs`)
- Operator → Live event UI: reviews events (evidence: `wardyn/src/tui.rs`)
- Live event UI → Run orchestrator: requests exception (evidence: `wardyn/src/main.rs`)
