# kshitij-tripathi87/workflo architecture

> Architecture diagram of the GitHub repository kshitij-tripathi87/workflo, 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/kshitij-tripathi87/workflo
- Repository: https://github.com/kshitij-tripathi87/workflo

## Overview

Workflo is documented as a privacy-first autonomous QA agent: users invoke the CLI to run tests or security/deep-test workloads in isolated sandboxes, then inspect or independently verify signed execution receipts. The tree also contains a distinct Cortex data-governance application for asset impact analysis, recommendations, future search, compliance, and writeback; its frontend and backend are represented as a separate product branch. Edges reflect the README and shown source/index references; unsampled integrations are not inferred.

Main entry points: [`apps/workflo-cli/src/workflo_cli/main.py`](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/workflo-cli/src/workflo_cli/main.py) (Workflo CLI), [`backend/app/main.py`](https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/main.py) (Cortex API), [`apps/workflo-cli/src/workflo_cli/supervisor_client.py`](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/workflo-cli/src/workflo_cli/supervisor_client.py) (Supervisor Client), [`packages/sandbox-runtime/src/sandbox_runtime/workloads/app.py`](https://github.com/kshitij-tripathi87/workflo/blob/main/packages/sandbox-runtime/src/sandbox_runtime/workloads/app.py) (App Workload)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_qa["QA Run Experience"]
  node_cli["Workflo CLI<br/>[main.py]"]
  node_receipt["Receipt Verification<br/>[verify_receipts.py]"]
  node_supervisor_client["Supervisor Client"]
end

subgraph group_runtime["Isolated Execution"]
  node_executor["Sandbox Executor<br/>[executor.py]"]
  node_runtime_cfg["Runtime Config<br/>[config.py]"]
  node_app_workload["App Workload<br/>[app.py]"]
  node_isolation["Isolation Controls"]
  node_probe["Probe Engine<br/>[runner.py]"]
  node_supervisor["Supervisor Daemon<br/>[daemon.py]"]
  node_worker["Worker Engine<br/>[main.py]"]
end

subgraph group_control["Run Services"]
  node_control_api["Control Plane API<br/>[main.py]"]
  node_control_db[("Control Plane Store<br/>[database.py]")]
end

subgraph group_cortex["Cortex Governance"]
  node_cortex_ui["Cortex Console<br/>[page.tsx]"]
  node_cortex_api["Cortex API<br/>[main.py]"]
  node_impact["Impact Analysis<br/>[impact_engine.py]"]
  node_future_search["Future Search"]
  node_recommendations["Recommendations"]
  node_cortex_store[("Cortex Store<br/>[models.py]")]
end

node_developer(("Developer"))

node_developer -->|"invokes"| node_cli
node_cli -->|"runs tests"| node_executor
node_cli -->|"configures isolation"| node_isolation
node_cli -->|"verifies receipt"| node_receipt
node_cli -->|"dispatches runs"| node_supervisor_client
node_supervisor_client -->|"uses IPC"| node_supervisor
node_supervisor_client -->|"uses config"| node_runtime_cfg
node_executor -.->|"runs workload"| node_app_workload
node_app_workload -->|"reads config"| node_runtime_cfg
node_app_workload -->|"uses isolation"| node_isolation
node_worker -.->|"executes probes"| node_probe
node_worker -->|"uses executor"| node_executor
node_control_api -->|"initializes store"| node_control_db
node_developer -.->|"uses console"| node_cortex_ui
node_cortex_ui -.->|"requests data"| node_cortex_api
node_cortex_api -.->|"routes analysis"| node_impact
node_cortex_api -.->|"routes search"| node_future_search
node_future_search -->|"evaluates impact"| node_impact
node_future_search -->|"ranks options"| node_recommendations
node_cortex_api -.->|"persists records"| node_cortex_store

click node_cli "https://github.com/kshitij-tripathi87/workflo/blob/main/apps/workflo-cli/src/workflo_cli/main.py"
click node_executor "https://github.com/kshitij-tripathi87/workflo/blob/main/apps/sandbox-executor/src/workflo_executor/executor.py"
click node_runtime_cfg "https://github.com/kshitij-tripathi87/workflo/blob/main/packages/sandbox-runtime/src/sandbox_runtime/config.py"
click node_app_workload "https://github.com/kshitij-tripathi87/workflo/blob/main/packages/sandbox-runtime/src/sandbox_runtime/workloads/app.py"
click node_isolation "https://github.com/kshitij-tripathi87/workflo/tree/main/packages/sandbox-isolation/src/sandbox_isolation"
click node_probe "https://github.com/kshitij-tripathi87/workflo/blob/main/packages/probe-engine/src/probe_engine/runner.py"
click node_receipt "https://github.com/kshitij-tripathi87/workflo/blob/main/packages/sandbox-isolation/src/sandbox_isolation/verify_receipts.py"
click node_supervisor_client "https://github.com/kshitij-tripathi87/workflo/blob/main/apps/workflo-cli/src/workflo_cli/supervisor_client.py"
click node_supervisor "https://github.com/kshitij-tripathi87/workflo/blob/main/supervisor/src/workflo_supervisor/daemon.py"
click node_worker "https://github.com/kshitij-tripathi87/workflo/blob/main/apps/worker-engine/src/workflo_worker/main.py"
click node_control_api "https://github.com/kshitij-tripathi87/workflo/blob/main/apps/control-plane/app/main.py"
click node_control_db "https://github.com/kshitij-tripathi87/workflo/blob/main/apps/control-plane/app/db/database.py"
click node_cortex_ui "https://github.com/kshitij-tripathi87/workflo/blob/main/frontend/app/page.tsx"
click node_cortex_api "https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/main.py"
click node_impact "https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/engine/impact_engine.py"
click node_future_search "https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/engine/future_search_engine.py"
click node_recommendations "https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/services/recommendation_engine.py"
click node_cortex_store "https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/db/models.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_cli,node_receipt,node_supervisor_client toneBlue
class node_executor,node_runtime_cfg,node_app_workload,node_isolation,node_probe,node_supervisor,node_worker toneAmber
class node_control_api,node_control_db toneMint
class node_cortex_ui,node_cortex_api,node_impact,node_future_search,node_recommendations,node_cortex_store toneRose
class node_developer toneIndigo
```

## Components

### QA Run Experience

- [Workflo CLI](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/workflo-cli/src/workflo_cli/main.py): `apps/workflo-cli/src/workflo_cli/main.py`
- [Receipt Verification](https://github.com/kshitij-tripathi87/workflo/blob/main/packages/sandbox-isolation/src/sandbox_isolation/verify_receipts.py): `packages/sandbox-isolation/src/sandbox_isolation/verify_receipts.py`
- [Supervisor Client](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/workflo-cli/src/workflo_cli/supervisor_client.py): `apps/workflo-cli/src/workflo_cli/supervisor_client.py`

### Isolated Execution

- [Sandbox Executor](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/sandbox-executor/src/workflo_executor/executor.py): `apps/sandbox-executor/src/workflo_executor/executor.py`
- [Runtime Config](https://github.com/kshitij-tripathi87/workflo/blob/main/packages/sandbox-runtime/src/sandbox_runtime/config.py): `packages/sandbox-runtime/src/sandbox_runtime/config.py`
- [App Workload](https://github.com/kshitij-tripathi87/workflo/blob/main/packages/sandbox-runtime/src/sandbox_runtime/workloads/app.py): `packages/sandbox-runtime/src/sandbox_runtime/workloads/app.py`
- [Isolation Controls](https://github.com/kshitij-tripathi87/workflo/tree/main/packages/sandbox-isolation/src/sandbox_isolation): `packages/sandbox-isolation/src/sandbox_isolation`
- [Probe Engine](https://github.com/kshitij-tripathi87/workflo/blob/main/packages/probe-engine/src/probe_engine/runner.py): `packages/probe-engine/src/probe_engine/runner.py`
- [Supervisor Daemon](https://github.com/kshitij-tripathi87/workflo/blob/main/supervisor/src/workflo_supervisor/daemon.py): `supervisor/src/workflo_supervisor/daemon.py`
- [Worker Engine](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/worker-engine/src/workflo_worker/main.py): `apps/worker-engine/src/workflo_worker/main.py`

### Run Services

- [Control Plane API](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/control-plane/app/main.py): `apps/control-plane/app/main.py`
- [Control Plane Store](https://github.com/kshitij-tripathi87/workflo/blob/main/apps/control-plane/app/db/database.py): `apps/control-plane/app/db/database.py`

### Cortex Governance

- [Cortex Console](https://github.com/kshitij-tripathi87/workflo/blob/main/frontend/app/page.tsx): `frontend/app/page.tsx`
- [Cortex API](https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/main.py): `backend/app/main.py`
- [Impact Analysis](https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/engine/impact_engine.py): `backend/app/engine/impact_engine.py`
- [Future Search](https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/engine/future_search_engine.py): `backend/app/engine/future_search_engine.py`
- [Recommendations](https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/services/recommendation_engine.py): `backend/app/services/recommendation_engine.py`
- [Cortex Store](https://github.com/kshitij-tripathi87/workflo/blob/main/backend/app/db/models.py): `backend/app/db/models.py`

### Other components

- **Developer**

## Connections

- Developer → Workflo CLI: invokes
- Workflo CLI → Sandbox Executor: runs tests (evidence: `apps/workflo-cli/src/workflo_cli/main.py`)
- Workflo CLI → Isolation Controls: configures isolation (evidence: `apps/workflo-cli/src/workflo_cli/main.py`)
- Workflo CLI → Receipt Verification: verifies receipt
- Workflo CLI → Supervisor Client: dispatches runs (evidence: `apps/workflo-cli/src/workflo_cli/main.py`)
- Supervisor Client → Supervisor Daemon: uses IPC (evidence: `apps/workflo-cli/src/workflo_cli/supervisor_client.py`)
- Supervisor Client → Runtime Config: uses config (evidence: `apps/workflo-cli/src/workflo_cli/supervisor_client.py`)
- Sandbox Executor → App Workload: runs workload
- App Workload → Runtime Config: reads config (evidence: `packages/sandbox-runtime/src/sandbox_runtime/workloads/app.py`)
- App Workload → Isolation Controls: uses isolation (evidence: `packages/sandbox-runtime/src/sandbox_runtime/workloads/app.py`)
- Worker Engine → Probe Engine: executes probes
- Worker Engine → Sandbox Executor: uses executor (evidence: `apps/worker-engine/src/workflo_worker/main.py`)
- Control Plane API → Control Plane Store: initializes store (evidence: `apps/control-plane/app/main.py`)
- Developer → Cortex Console: uses console
- Cortex Console → Cortex API: requests data
- Cortex API → Impact Analysis: routes analysis
- Cortex API → Future Search: routes search
- Future Search → Impact Analysis: evaluates impact (evidence: `backend/app/engine/future_search_engine.py`)
- Future Search → Recommendations: ranks options (evidence: `backend/app/engine/future_search_engine.py`)
- Cortex API → Cortex Store: persists records
