# crabnebula-dev/tauri-fuzz architecture

> Architecture diagram of the GitHub repository crabnebula-dev/tauri-fuzz, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/crabnebula-dev/tauri-fuzz
- Repository: https://github.com/crabnebula-dev/tauri-fuzz

## Overview

##### Main Components Identification
The system consists of three main crates and several supporting components:

a. Core Components:
- tauri-fuzz-cli (Command Line Interface)
- tauri-fuzz (Runtime Environment)
- tauri-fuzz-policies (Security Policies Engine)

**┌─ CLI Interface (tauri-fuzz-cli) ─┐**
- Init Command
- Fuzz Command
- Utility Functions

**┌─ Tauri-Fuzz Runtime ─┐**
- Fuzzer Engine
- Runtime Environment
- LibAFL Integration
- Frida Integration

**┌─ Security Policies ─┐**
- Policy Engine
- External Process Policies
- Filesystem Policies
- Custom Policies

##### Component Relationships

- CLI → Runtime (initialization and control flow)
- Runtime → Policy Engine (policy enforcement)
- Runtime → Target Application (instrumentation and monitoring)
- Policy Engine → Target Application (security boundary enforcement)

##### Additional Elements

- Fuzzing targets
- Template system
- Test infrastructure
- Documentation system

##### Data Flow Indicators

Show:
- Input generation flow
- Security policy checking flow
- Violation reporting
- Fuzzing feedback loop

##### The integration with external tools

Keep the abstraction level focused on the architectural components while maintaining enough detail to show the security boundary enforcement mechanism, which is the project's key differentiator from traditional fuzzers.

- Component types
- Platform support indicators
- Security boundary markers

This system design should clearly communicate how the fuzzer specializes in detecting security boundary violations while maintaining its cross-platform capabilities and integration with established fuzzing tools.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph CLI["CLI Layer"]
        InitCmd["Init Command"]:::cli
        FuzzCmd["Fuzz Command"]:::cli
        UtilFn["Utility Functions"]:::cli
    end

    subgraph Runtime["Runtime Layer"]
        FuzzEngine["Fuzzer Engine"]:::runtime
        RuntimeEnv["Runtime Environment"]:::runtime
        RuntimeCore["Runtime Core"]:::runtime
        FuzzOpts["Fuzzer Options"]:::runtime
        TauriInt["Tauri Integration"]:::runtime
        TauriUtils["Tauri Utils"]:::runtime
        TauriMacros["Tauri Macros"]:::runtime
    end

    subgraph Security["Security Layer"]
        PolicyEngine["Policy Engine"]:::security
        ExtProcPol["External Process Policies"]:::security
        FsPol["Filesystem Policies"]:::security
        PolTemplate["Policy Template"]:::security
    end

    subgraph External["External Components"]
        LibAFL["LibAFL"]:::external
        Frida["Frida"]:::external
        TargetApp["Target Application"]:::external
    end

    subgraph Config["Configuration"]
        FuzzConfig["Fuzzer Configuration"]:::config
        CLITemplate["CLI Template"]:::config
    end

    %% Relationships
    InitCmd --> RuntimeEnv
    FuzzCmd --> FuzzEngine
    UtilFn --> RuntimeEnv

    FuzzEngine --> PolicyEngine
    RuntimeEnv --> PolicyEngine
    RuntimeCore --> TauriInt
    FuzzOpts --> FuzzEngine
    
    PolicyEngine --> ExtProcPol
    PolicyEngine --> FsPol
    PolicyEngine --> PolTemplate

    FuzzEngine --> LibAFL
    FuzzEngine --> Frida
    Frida --> TargetApp
    
    PolicyEngine --> TargetApp
    FuzzConfig --> RuntimeEnv
    CLITemplate --> InitCmd

    %% Click Events
    click InitCmd "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz-cli/src/init.rs"
    click FuzzCmd "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz-cli/src/fuzz.rs"
    click UtilFn "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz-cli/src/util.rs"
    click FuzzEngine "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz/src/fuzzer.rs"
    click RuntimeEnv "https://github.com/crabnebula-dev/tauri-fuzz/tree/main/crates/tauri-fuzz/src/runtime/"
    click RuntimeCore "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz/src/runtime.rs"
    click FuzzOpts "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz/src/fuzzer_options.rs"
    click PolicyEngine "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz-policies/src/engine.rs"
    click ExtProcPol "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz-policies/src/policies/external_process.rs"
    click FsPol "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz-policies/src/policies/filesystem.rs"
    click PolTemplate "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz-policies/src/policies/policy_template.rs"
    click TauriInt "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz/src/tauri.rs"
    click TauriUtils "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz/src/tauri/utils.rs"
    click TauriMacros "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz/src/tauri/macros.rs"
    click FuzzConfig "https://github.com/crabnebula-dev/tauri-fuzz/blob/main/crates/tauri-fuzz/configuration/toml_template.toml"
    click CLITemplate "https://github.com/crabnebula-dev/tauri-fuzz/tree/main/crates/tauri-fuzz-cli/template/"

    %% Styles
    classDef cli fill:#3498db,stroke:#2980b9,color:white
    classDef runtime fill:#2ecc71,stroke:#27ae60,color:white
    classDef security fill:#e74c3c,stroke:#c0392b,color:white
    classDef external fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef config fill:#f1c40f,stroke:#f39c12,color:black
```
