# trustops-dev/trustops-ai architecture

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

- Interactive diagram: https://gitdiagram.com/trustops-dev/trustops-ai
- Repository: https://github.com/trustops-dev/trustops-ai

## Overview

TrustOps AI is currently a repository base, not an implemented reliability platform: Python packages are installable shells, the API has no routers, and the dashboard only renders a minimal landing page. The planned product spans trace instrumentation and platform services, reliability evaluation and diagnosis, governance, and procurement/RAG reference applications. The graph preserves those documented boundaries, but their domain behavior and connections are not implemented or evidenced in the sampled source; the README says the reference-application contracts are drafts.

Main entry points: [`apps/dashboard/src/app/page.tsx`](https://github.com/trustops-dev/trustops-ai/blob/main/apps/dashboard/src/app/page.tsx) (Landing page), [`apps/dashboard/src/app/layout.tsx`](https://github.com/trustops-dev/trustops-ai/blob/main/apps/dashboard/src/app/layout.tsx) (Root layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard"]
  node_home["Landing page<br/>[page.tsx]"]
  node_layout["Root layout<br/>[layout.tsx]"]
  node_trace_explorer["Trace explorer"]
  node_failure_rca["Failure diagnosis"]
  node_release_gate["Release gate"]
  node_rag_diagnostics["RAG diagnostics"]
  node_applications_view["Applications view"]
end

subgraph group_platform["Platform services"]
  node_api["HTTP API shell"]
  node_platform_core["Trace platform"]
  node_sdk["Instrumentation SDK"]
  node_contracts["Shared contracts"]
end

subgraph group_engines["Decision engines"]
  node_reliability["Reliability engine"]
  node_governance["Governance engine"]
  node_mlops["ML operations"]
end

subgraph group_applications["Reference applications"]
  node_procurement["Procurement agent"]
  node_rag["RAG assistant"]
end

node_user(("User"))

node_user -->|"opens"| node_home
node_layout -.->|"renders children"| node_home

click node_home "https://github.com/trustops-dev/trustops-ai/blob/main/apps/dashboard/src/app/page.tsx"
click node_layout "https://github.com/trustops-dev/trustops-ai/blob/main/apps/dashboard/src/app/layout.tsx"
click node_api "https://github.com/trustops-dev/trustops-ai/tree/main/apps/api/src/trustops_api"
click node_platform_core "https://github.com/trustops-dev/trustops-ai/tree/main/packages/platform-core/src/trustops_platform"
click node_sdk "https://github.com/trustops-dev/trustops-ai/tree/main/packages/instrumentation-sdk/src/trustops_sdk"
click node_contracts "https://github.com/trustops-dev/trustops-ai/tree/main/packages/contracts/src/trustops_contracts"
click node_reliability "https://github.com/trustops-dev/trustops-ai/tree/main/packages/reliability-engine/src/trustops_reliability"
click node_governance "https://github.com/trustops-dev/trustops-ai/tree/main/packages/governance-engine/src/trustops_governance"
click node_mlops "https://github.com/trustops-dev/trustops-ai/tree/main/packages/mlops/src/trustops_mlops"
click node_procurement "https://github.com/trustops-dev/trustops-ai/tree/main/apps/procurement-agent/src/trustops_procurement_agent"
click node_rag "https://github.com/trustops-dev/trustops-ai/tree/main/apps/rag-assistant/src/trustops_rag_assistant"
click node_trace_explorer "https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/traces"
click node_failure_rca "https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/failure-rca"
click node_release_gate "https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/release-gate"
click node_rag_diagnostics "https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/rag-diagnostics"
click node_applications_view "https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/applications"

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_home,node_layout,node_trace_explorer,node_failure_rca,node_release_gate,node_rag_diagnostics,node_applications_view,node_user toneBlue
class node_api,node_platform_core,node_sdk,node_contracts toneAmber
class node_reliability,node_governance,node_mlops toneMint
class node_procurement,node_rag toneRose
```

## Components

### Dashboard

- [Landing page](https://github.com/trustops-dev/trustops-ai/blob/main/apps/dashboard/src/app/page.tsx): `apps/dashboard/src/app/page.tsx`
- [Root layout](https://github.com/trustops-dev/trustops-ai/blob/main/apps/dashboard/src/app/layout.tsx): `apps/dashboard/src/app/layout.tsx`
- [Trace explorer](https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/traces): `apps/dashboard/src/app/traces`
- [Failure diagnosis](https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/failure-rca): `apps/dashboard/src/app/failure-rca`
- [Release gate](https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/release-gate): `apps/dashboard/src/app/release-gate`
- [RAG diagnostics](https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/rag-diagnostics): `apps/dashboard/src/app/rag-diagnostics`
- [Applications view](https://github.com/trustops-dev/trustops-ai/tree/main/apps/dashboard/src/app/applications): `apps/dashboard/src/app/applications`

### Platform services

- [HTTP API shell](https://github.com/trustops-dev/trustops-ai/tree/main/apps/api/src/trustops_api): `apps/api/src/trustops_api`
- [Trace platform](https://github.com/trustops-dev/trustops-ai/tree/main/packages/platform-core/src/trustops_platform): `packages/platform-core/src/trustops_platform`
- [Instrumentation SDK](https://github.com/trustops-dev/trustops-ai/tree/main/packages/instrumentation-sdk/src/trustops_sdk): `packages/instrumentation-sdk/src/trustops_sdk`
- [Shared contracts](https://github.com/trustops-dev/trustops-ai/tree/main/packages/contracts/src/trustops_contracts): `packages/contracts/src/trustops_contracts`

### Decision engines

- [Reliability engine](https://github.com/trustops-dev/trustops-ai/tree/main/packages/reliability-engine/src/trustops_reliability): `packages/reliability-engine/src/trustops_reliability`
- [Governance engine](https://github.com/trustops-dev/trustops-ai/tree/main/packages/governance-engine/src/trustops_governance): `packages/governance-engine/src/trustops_governance`
- [ML operations](https://github.com/trustops-dev/trustops-ai/tree/main/packages/mlops/src/trustops_mlops): `packages/mlops/src/trustops_mlops`

### Reference applications

- [Procurement agent](https://github.com/trustops-dev/trustops-ai/tree/main/apps/procurement-agent/src/trustops_procurement_agent): `apps/procurement-agent/src/trustops_procurement_agent`
- [RAG assistant](https://github.com/trustops-dev/trustops-ai/tree/main/apps/rag-assistant/src/trustops_rag_assistant): `apps/rag-assistant/src/trustops_rag_assistant`

### Other components

- **User**

## Connections

- User → Landing page: opens (evidence: `README.md`)
- Root layout → Landing page: renders children