# 2faced0w0/trustfall architecture

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

- Interactive diagram: https://gitdiagram.com/2faced0w0/trustfall
- Repository: https://github.com/2faced0w0/trustfall

## Overview

TRUSTFALL pre-event kit verifies an event environment and provides a stable model interface for offline or live-provider use. The operator runs readiness checks, which validate the request contract and deterministic mock model, then write a non-sensitive readiness report; provider checks can separately exercise configured live adapters. The factory selects an adapter, whose generation method returns a normalized result. Provider implementations beyond the sampled excerpts are represented at their existing models/ directory; their internal behavior is not inferred.

Main entry points: [`trustfall-pre-event-kit/models/factory.py`](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/factory.py) (Adapter factory), [`trustfall-pre-event-kit/scripts/check_environment.py`](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/scripts/check_environment.py) (Environment check), [`trustfall-pre-event-kit/models/base.py`](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/base.py) (HTTP helper), [`trustfall-pre-event-kit/models/cohere.py`](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/cohere.py) (Cohere adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_readiness["Readiness checks"]
  node_environment_check["Environment check"]
  node_provider_check["Provider check<br/>[check_providers.py]"]
  node_report_writer["Report writer"]
  node_readiness_report["Readiness report"]
end

subgraph group_contract["Smoke contract"]
  node_smoke_contract["Smoke contract<br/>[smoke_app.py]"]
end

subgraph group_models["Model adapters"]
  node_factory["Adapter factory<br/>[factory.py]"]
  node_model_interface["Model interface<br/>[base.py]"]
  node_mock_adapter["Mock adapter<br/>[mock.py]"]
  node_cohere_adapter["Cohere adapter<br/>[cohere.py]"]
  node_google_adapter["Google adapter<br/>[google.py]"]
  node_other_adapters["Other adapters"]
end

subgraph group_http["Provider transport"]
  node_request_helper["HTTP helper<br/>[base.py]"]
end

node_operator(("Event operator"))
node_provider_apis{{"Model provider APIs"}}

node_operator -->|"runs"| node_environment_check
node_operator -->|"runs"| node_provider_check
node_environment_check -->|"creates mock"| node_factory
node_environment_check -->|"checks contract"| node_smoke_contract
node_environment_check -->|"writes report"| node_report_writer
node_report_writer -->|"writes JSON"| node_readiness_report
node_provider_check -->|"creates adapters"| node_factory
node_factory -->|"creates mock"| node_mock_adapter
node_factory -->|"selects adapter"| node_cohere_adapter
node_factory -->|"selects adapter"| node_google_adapter
node_factory -->|"selects adapter"| node_other_adapters
node_mock_adapter -->|"implements"| node_model_interface
node_cohere_adapter -->|"uses interface"| node_model_interface
node_google_adapter -->|"uses interface"| node_model_interface
node_other_adapters -->|"uses interface"| node_model_interface
node_cohere_adapter -->|"sends request"| node_request_helper
node_google_adapter -->|"sends request"| node_request_helper
node_other_adapters -.->|"sends request"| node_request_helper
node_request_helper -->|"sends HTTP"| node_provider_apis

click node_environment_check "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/scripts/check_environment.py"
click node_provider_check "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/scripts/check_providers.py"
click node_report_writer "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/smoke/environment_report.py"
click node_smoke_contract "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/smoke/smoke_app.py"
click node_factory "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/factory.py"
click node_model_interface "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/base.py"
click node_mock_adapter "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/mock.py"
click node_cohere_adapter "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/cohere.py"
click node_google_adapter "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/google.py"
click node_other_adapters "https://github.com/2faced0w0/trustfall/tree/main/trustfall-pre-event-kit/models"
click node_request_helper "https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/base.py"

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_environment_check,node_provider_check,node_report_writer,node_readiness_report toneBlue
class node_smoke_contract toneAmber
class node_factory,node_model_interface,node_mock_adapter,node_cohere_adapter,node_google_adapter,node_other_adapters,node_provider_apis toneMint
class node_request_helper toneRose
class node_operator toneIndigo
```

## Components

### Readiness checks

- [Environment check](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/scripts/check_environment.py): `trustfall-pre-event-kit/scripts/check_environment.py`
- [Provider check](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/scripts/check_providers.py): `trustfall-pre-event-kit/scripts/check_providers.py`
- [Report writer](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/smoke/environment_report.py): `trustfall-pre-event-kit/smoke/environment_report.py`
- **Readiness report**

### Smoke contract

- [Smoke contract](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/smoke/smoke_app.py): `trustfall-pre-event-kit/smoke/smoke_app.py`

### Model adapters

- [Adapter factory](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/factory.py): `trustfall-pre-event-kit/models/factory.py`
- [Model interface](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/base.py): `trustfall-pre-event-kit/models/base.py`
- [Mock adapter](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/mock.py): `trustfall-pre-event-kit/models/mock.py`
- [Cohere adapter](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/cohere.py): `trustfall-pre-event-kit/models/cohere.py`
- [Google adapter](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/google.py): `trustfall-pre-event-kit/models/google.py`
- [Other adapters](https://github.com/2faced0w0/trustfall/tree/main/trustfall-pre-event-kit/models): `trustfall-pre-event-kit/models`

### Provider transport

- [HTTP helper](https://github.com/2faced0w0/trustfall/blob/main/trustfall-pre-event-kit/models/base.py): `trustfall-pre-event-kit/models/base.py`

### Other components

- **Event operator**
- **Model provider APIs**

## Connections

- Event operator → Environment check: runs (evidence: `trustfall-pre-event-kit/scripts/check_environment.py`)
- Event operator → Provider check: runs (evidence: `trustfall-pre-event-kit/scripts/check_providers.py`)
- Environment check → Adapter factory: creates mock (evidence: `trustfall-pre-event-kit/scripts/check_environment.py`)
- Environment check → Smoke contract: checks contract (evidence: `trustfall-pre-event-kit/scripts/check_environment.py`)
- Environment check → Report writer: writes report (evidence: `trustfall-pre-event-kit/scripts/check_environment.py`)
- Report writer → Readiness report: writes JSON (evidence: `trustfall-pre-event-kit/smoke/environment_report.py`)
- Provider check → Adapter factory: creates adapters (evidence: `trustfall-pre-event-kit/scripts/check_providers.py`)
- Adapter factory → Mock adapter: creates mock (evidence: `trustfall-pre-event-kit/models/factory.py`)
- Adapter factory → Cohere adapter: selects adapter (evidence: `trustfall-pre-event-kit/models/factory.py`)
- Adapter factory → Google adapter: selects adapter (evidence: `trustfall-pre-event-kit/models/factory.py`)
- Adapter factory → Other adapters: selects adapter (evidence: `trustfall-pre-event-kit/models/factory.py`)
- Mock adapter → Model interface: implements (evidence: `trustfall-pre-event-kit/models/mock.py`)
- Cohere adapter → Model interface: uses interface (evidence: `trustfall-pre-event-kit/models/cohere.py`)
- Google adapter → Model interface: uses interface (evidence: `trustfall-pre-event-kit/models/google.py`)
- Other adapters → Model interface: uses interface (evidence: `trustfall-pre-event-kit/models/factory.py`)
- Cohere adapter → HTTP helper: sends request (evidence: `trustfall-pre-event-kit/models/cohere.py`)
- Google adapter → HTTP helper: sends request (evidence: `trustfall-pre-event-kit/models/google.py`)
- Other adapters → HTTP helper: sends request (evidence: `trustfall-pre-event-kit/models/openrouter.py`)
- HTTP helper → Model provider APIs: sends HTTP (evidence: `trustfall-pre-event-kit/models/base.py`)
