# zackpratamaa/cekas-agent architecture

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

- Interactive diagram: https://gitdiagram.com/zackpratamaa/cekas-agent
- Repository: https://github.com/zackpratamaa/cekas-agent

## Overview

CEKAS.AGENT is a self-hosted mission-management and autonomous-security-agent foundation, currently implemented as a fixture-only vertical slice. Users submit and manage missions through the API, CLI, or dashboard; starting a mission schedules fixture execution, whose proposal is checked against scope and enabled capabilities before synthetic evidence and a clearly limited report are saved. The README also describes PostgreSQL-backed persistence and the dashboard/CLI interfaces. Core execution links are supported by excerpts and the source index; the dashboard-to-API connection is not shown in sampled source, so it is marked unverified.

Main entry points: [`packages/core/src/cekas_core/execution.py`](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/execution.py) (Fixture agent loop), [`apps/api/src/cekas_api/app.py`](https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/app.py) (FastAPI application), [`apps/api/src/cekas_api/service.py`](https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/service.py) (Mission service), [`packages/core/src/cekas_core/domain.py`](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/domain.py) (Mission domain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_dashboard["Web dashboard<br/>[mission-app.tsx]"]
  node_cli["Command-line interface<br/>[main.py]"]
end

subgraph group_mission["Mission management"]
  node_api["FastAPI application<br/>[app.py]"]
  node_schemas["API schemas<br/>[schemas.py]"]
  node_service["Mission service<br/>[service.py]"]
  node_domain["Mission domain<br/>[domain.py]"]
end

subgraph group_execution["Fixture execution"]
  node_loop["Fixture agent loop<br/>[execution.py]"]
  node_models["Fixture model adapter<br/>[contracts.py]"]
  node_policy["Scope admission<br/>[admission.py]"]
  node_capabilities["Capability registry<br/>[registry.py]"]
  node_worker["Fixture worker<br/>[fixture.py]"]
  node_report["Synthetic report<br/>[report.py]"]
end

subgraph group_persistence["Persistence and evidence"]
  node_repository["Repository contract<br/>[repository.py]"]
  node_postgres["PostgreSQL repository"]
  node_database[("PostgreSQL database")]
end

node_user(("Operator"))

node_user -->|"submits missions"| node_api
node_user -->|"runs commands"| node_cli
node_user -->|"manages fixtures"| node_dashboard
node_dashboard -.->|"sends requests"| node_api
node_api -->|"uses schemas"| node_schemas
node_api -->|"creates missions"| node_service
node_api -->|"reads and starts"| node_repository
node_api -->|"configures repository"| node_postgres
node_service -->|"builds revisions"| node_domain
node_service -->|"saves and finishes"| node_repository
node_service -->|"runs fixture"| node_loop
node_postgres -->|"reads and writes"| node_database
node_loop -->|"requests proposal"| node_models
node_loop -->|"checks admission"| node_policy
node_loop -->|"gets enabled IDs"| node_capabilities
node_loop -->|"executes proposal"| node_worker
node_loop -->|"builds report"| node_report
node_worker -->|"creates evidence"| node_domain
node_report -->|"reads mission and evidence"| node_domain

click node_dashboard "https://github.com/zackpratamaa/cekas-agent/blob/main/apps/dashboard/src/mission-app.tsx"
click node_cli "https://github.com/zackpratamaa/cekas-agent/blob/main/apps/cli/src/cekas_cli/main.py"
click node_api "https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/app.py"
click node_schemas "https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/schemas.py"
click node_service "https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/service.py"
click node_domain "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/domain.py"
click node_repository "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/repository.py"
click node_postgres "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/postgres_repository.py"
click node_loop "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/execution.py"
click node_models "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/model-adapters/src/cekas_models/contracts.py"
click node_policy "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/policy/src/cekas_policy/admission.py"
click node_capabilities "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/capabilities/src/cekas_capabilities/registry.py"
click node_worker "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/worker/src/cekas_worker/fixture.py"
click node_report "https://github.com/zackpratamaa/cekas-agent/blob/main/packages/evidence/src/cekas_evidence/report.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_dashboard,node_cli toneBlue
class node_api,node_schemas,node_service,node_domain toneAmber
class node_loop,node_models,node_policy,node_capabilities,node_worker,node_report toneMint
class node_repository,node_postgres,node_database toneRose
class node_user toneIndigo
```

## Components

### User interfaces

- [Web dashboard](https://github.com/zackpratamaa/cekas-agent/blob/main/apps/dashboard/src/mission-app.tsx): `apps/dashboard/src/mission-app.tsx`
- [Command-line interface](https://github.com/zackpratamaa/cekas-agent/blob/main/apps/cli/src/cekas_cli/main.py): `apps/cli/src/cekas_cli/main.py`

### Mission management

- [FastAPI application](https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/app.py): `apps/api/src/cekas_api/app.py`
- [API schemas](https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/schemas.py): `apps/api/src/cekas_api/schemas.py`
- [Mission service](https://github.com/zackpratamaa/cekas-agent/blob/main/apps/api/src/cekas_api/service.py): `apps/api/src/cekas_api/service.py`
- [Mission domain](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/domain.py): `packages/core/src/cekas_core/domain.py`

### Fixture execution

- [Fixture agent loop](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/execution.py): `packages/core/src/cekas_core/execution.py`
- [Fixture model adapter](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/model-adapters/src/cekas_models/contracts.py): `packages/model-adapters/src/cekas_models/contracts.py`
- [Scope admission](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/policy/src/cekas_policy/admission.py): `packages/policy/src/cekas_policy/admission.py`
- [Capability registry](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/capabilities/src/cekas_capabilities/registry.py): `packages/capabilities/src/cekas_capabilities/registry.py`
- [Fixture worker](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/worker/src/cekas_worker/fixture.py): `packages/worker/src/cekas_worker/fixture.py`
- [Synthetic report](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/evidence/src/cekas_evidence/report.py): `packages/evidence/src/cekas_evidence/report.py`

### Persistence and evidence

- [Repository contract](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/repository.py): `packages/core/src/cekas_core/repository.py`
- [PostgreSQL repository](https://github.com/zackpratamaa/cekas-agent/blob/main/packages/core/src/cekas_core/postgres_repository.py): `packages/core/src/cekas_core/postgres_repository.py`
- **PostgreSQL database**

### Other components

- **Operator**

## Connections

- Operator → FastAPI application: submits missions (evidence: `README.md`)
- Operator → Command-line interface: runs commands (evidence: `README.md`)
- Operator → Web dashboard: manages fixtures (evidence: `README.md`)
- Web dashboard → FastAPI application: sends requests
- FastAPI application → API schemas: uses schemas (evidence: `apps/api/src/cekas_api/app.py`)
- FastAPI application → Mission service: creates missions (evidence: `apps/api/src/cekas_api/app.py`)
- FastAPI application → Repository contract: reads and starts (evidence: `apps/api/src/cekas_api/app.py`)
- FastAPI application → PostgreSQL repository: configures repository (evidence: `apps/api/src/cekas_api/app.py`)
- Mission service → Mission domain: builds revisions (evidence: `apps/api/src/cekas_api/service.py`)
- Mission service → Repository contract: saves and finishes (evidence: `apps/api/src/cekas_api/service.py`)
- Mission service → Fixture agent loop: runs fixture (evidence: `apps/api/src/cekas_api/service.py`)
- PostgreSQL repository → PostgreSQL database: reads and writes (evidence: `packages/core/src/cekas_core/postgres_repository.py`)
- Fixture agent loop → Fixture model adapter: requests proposal (evidence: `packages/core/src/cekas_core/execution.py`)
- Fixture agent loop → Scope admission: checks admission (evidence: `packages/core/src/cekas_core/execution.py`)
- Fixture agent loop → Capability registry: gets enabled IDs (evidence: `packages/core/src/cekas_core/execution.py`)
- Fixture agent loop → Fixture worker: executes proposal (evidence: `packages/core/src/cekas_core/execution.py`)
- Fixture agent loop → Synthetic report: builds report (evidence: `packages/core/src/cekas_core/execution.py`)
- Fixture worker → Mission domain: creates evidence (evidence: `packages/worker/src/cekas_worker/fixture.py`)
- Synthetic report → Mission domain: reads mission and evidence (evidence: `packages/evidence/src/cekas_evidence/report.py`)
