How aryannehe/klarnova works
Klarnova turns monitoring alerts into incidents, investigates them with a staged agent workflow, gates and executes remediation, then records outcomes for learning and knowledge-base updates. Operators can review incidents and approvals through the dashboard or API. The graph preserves README-documented capabilities even where their implementation was not sampled; edges without source-level evidence are limited to relationships explicitly described in the README.
Main entry points: graph.py Graph Orchestrator · webhooks.py Alert Webhook · main.py Backend API Routing · approval.py Approval API
Components 26
Alert Intake
- Alert Webhook
backend/app/api/webhooks.py - Incident Records
backend/app/models/domain.py - Backend API Routing
backend/app/main.py - Application Database
backend/app/core/database.py
Agent Workflows
- Graph Orchestrator
backend/app/agents/graph.py - Evidence Gathering
backend/app/agents/investigation.py - Runbook Retrieval
backend/app/agents/retrieval.py - Root Cause Diagnosis
backend/app/agents/root_cause.py - Action Planning
backend/app/agents/planning.py - Incident Reporting
backend/app/agents/reporting.py
Safety and Remediation
- Safety Gate
backend/app/agents/safety.py - Risk Policy Engine
backend/app/policy/engine.py - Kubernetes Remediation
backend/app/agents/remediation.py - Kubernetes Actions
backend/app/k8s/actions.py - Kubernetes Client
backend/app/k8s/client.py - Recovery Validation
backend/app/agents/validation.py
Learning and Knowledge
- Vector Knowledge Store
backend/app/rag/store.py - Knowledge Ingestion
backend/app/rag/ingest.py - Incident Write-back
backend/app/rag/writeback.py - Contextual Bandit
backend/app/bandit/learning.py
Operator Experience
- Approval API
backend/app/api/approval.py - Notifications
backend/app/services/notify.py - Operator Dashboard
frontend/app/(dashboard)/incidents/page.tsx - Dashboard API Client
frontend/lib/api.ts
Other components
- Prometheus / Alertmanager
- Operator
Connections 31
- Prometheus / Alertmanager → Alert Webhook: posts alerts
- Alert Webhook → Incident Records: creates incident
backend/app/api/webhooks.py - Alert Webhook → Graph Orchestrator: invokes investigation
backend/app/api/webhooks.py - Graph Orchestrator → Evidence Gathering: runs first
backend/app/agents/graph.py - Graph Orchestrator → Runbook Retrieval: runs next
backend/app/agents/graph.py - Graph Orchestrator → Root Cause Diagnosis: runs next
backend/app/agents/graph.py - Graph Orchestrator → Action Planning: runs next
backend/app/agents/graph.py - Graph Orchestrator → Safety Gate: runs last
backend/app/agents/graph.py - Evidence Gathering → Kubernetes Client: collects evidence
backend/app/agents/investigation.py - Runbook Retrieval → Vector Knowledge Store: searches documents
backend/app/agents/retrieval.py - Safety Gate → Risk Policy Engine: checks risk
- Operator → Approval API: approves actions
- Approval API → Graph Orchestrator: resumes remediation
backend/app/api/approval.py - Alert Webhook → Graph Orchestrator: invokes remediation
backend/app/api/webhooks.py - Graph Orchestrator → Kubernetes Remediation: executes approved action
backend/app/agents/graph.py - Kubernetes Remediation → Kubernetes Actions: applies action
- Kubernetes Actions → Kubernetes Client: uses cluster client
- Graph Orchestrator → Recovery Validation: checks recovery
backend/app/agents/graph.py - Graph Orchestrator → Incident Reporting: reports outcome
backend/app/agents/graph.py - Alert Webhook → Application Database: persists results
backend/app/api/webhooks.py - Alert Webhook → Contextual Bandit: records outcome
backend/app/api/webhooks.py - Contextual Bandit → Risk Policy Engine: uses policy
backend/app/bandit/learning.py - Alert Webhook → Incident Write-back: writes resolved incidents
backend/app/api/webhooks.py - Incident Write-back → Vector Knowledge Store: adds knowledge
- Knowledge Ingestion → Vector Knowledge Store: seeds collections
backend/app/rag/ingest.py - Alert Webhook → Notifications: sends notifications
backend/app/api/webhooks.py - Operator → Operator Dashboard: reviews incidents
- Operator Dashboard → Dashboard API Client: requests data
- Dashboard API Client → Backend API Routing: calls backend
- Backend API Routing → Alert Webhook: routes webhook
backend/app/main.py - Backend API Routing → Approval API: routes approvals
backend/app/main.py