How zackpratamaa/cekas-agent works
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: execution.py Fixture agent loop · app.py FastAPI application · service.py Mission service · domain.py Mission domain
Components 16
User interfaces
- Web dashboard
apps/dashboard/src/mission-app.tsx - Command-line interface
apps/cli/src/cekas_cli/main.py
Mission management
- FastAPI application
apps/api/src/cekas_api/app.py - API schemas
apps/api/src/cekas_api/schemas.py - Mission service
apps/api/src/cekas_api/service.py - Mission domain
packages/core/src/cekas_core/domain.py
Fixture execution
- Fixture agent loop
packages/core/src/cekas_core/execution.py - Fixture model adapter
packages/model-adapters/src/cekas_models/contracts.py - Scope admission
packages/policy/src/cekas_policy/admission.py - Capability registry
packages/capabilities/src/cekas_capabilities/registry.py - Fixture worker
packages/worker/src/cekas_worker/fixture.py - Synthetic report
packages/evidence/src/cekas_evidence/report.py
Persistence and evidence
- Repository contract
packages/core/src/cekas_core/repository.py - PostgreSQL repository
packages/core/src/cekas_core/postgres_repository.py - PostgreSQL database
Other components
- Operator
Connections 19
- Operator → FastAPI application: submits missions
README.md - Operator → Command-line interface: runs commands
README.md - Operator → Web dashboard: manages fixtures
README.md - Web dashboard → FastAPI application: sends requests
- FastAPI application → API schemas: uses schemas
apps/api/src/cekas_api/app.py - FastAPI application → Mission service: creates missions
apps/api/src/cekas_api/app.py - FastAPI application → Repository contract: reads and starts
apps/api/src/cekas_api/app.py - FastAPI application → PostgreSQL repository: configures repository
apps/api/src/cekas_api/app.py - Mission service → Mission domain: builds revisions
apps/api/src/cekas_api/service.py - Mission service → Repository contract: saves and finishes
apps/api/src/cekas_api/service.py - Mission service → Fixture agent loop: runs fixture
apps/api/src/cekas_api/service.py - PostgreSQL repository → PostgreSQL database: reads and writes
packages/core/src/cekas_core/postgres_repository.py - Fixture agent loop → Fixture model adapter: requests proposal
packages/core/src/cekas_core/execution.py - Fixture agent loop → Scope admission: checks admission
packages/core/src/cekas_core/execution.py - Fixture agent loop → Capability registry: gets enabled IDs
packages/core/src/cekas_core/execution.py - Fixture agent loop → Fixture worker: executes proposal
packages/core/src/cekas_core/execution.py - Fixture agent loop → Synthetic report: builds report
packages/core/src/cekas_core/execution.py - Fixture worker → Mission domain: creates evidence
packages/worker/src/cekas_worker/fixture.py - Synthetic report → Mission domain: reads mission and evidence
packages/evidence/src/cekas_evidence/report.py