How harmansaini29/project-umbrella works
UMBRELLA is a risk-aware control plane for diagnosing backend incidents, planning and governing remediations, executing them with verification, and learning from outcomes. Operators or connected services submit incidents through the dashboard; the council runs diagnosis, topology analysis, planning, safety approval, and execution. Hybrid RAG supplies grounded evidence, while Agent 6 supports adaptation. The README also describes capsule-based disaster recovery. Edges reflect the README and excerpted/indexed source references; unsampled subsystem details and integrations are left unconnected where their wiring is not shown.
Main entry points: orchestrator.py Council Orchestrator · server.py Control Dashboard · hybrid_engine.py Hybrid Retrieval · analyzer.py Root Cause Analysis
Components 19
Incident Control
- Control Dashboard
dashboard/server.py - Incident Contracts
agents/schemas.py - Council Orchestrator
agents/orchestrator.py
Evidence Retrieval
- Hybrid Retrieval
rag/hybrid_engine.py - Keyword Index
rag/bm25_index.py - Vector Index
rag/vector_index.py
Remediation Council
- Root Cause Analysis
agents/agent1_rca/analyzer.py - Topology Mapper
agents/agent2_topology/visualizer.py - Remediation Planner
agents/agent3_planner/planner.py - Safety Guardian
agents/agent5_guardian/guardian.py - Sandbox Executor
agents/agent4_executor/executor.py
Learning and Recovery
- Evolution Learner
agents/agent6_evo/policy_learner.py - Outcome Memory
agents/agent6_evo/outcome_store.py - System DNA Capsule
capsule/dna_packager.py - Genesis Restore
capsule/genesis_engine.py
Managed Systems
- Managed Backend
target_system/demo_app/server.py - Backend Database
target_system/demo_app/database.py - Umbrella SDK
umbrella_sdk/client.py
Other components
- Operator / Client
Connections 19
- Operator / Client → Control Dashboard: reports incident
dashboard/server.py - Control Dashboard → Council Orchestrator: triggers council
dashboard/server.py - Control Dashboard → Incident Contracts: validates payload
dashboard/server.py - Council Orchestrator → Root Cause Analysis: runs diagnosis
agents/orchestrator.py - Council Orchestrator → Topology Mapper: maps impact
agents/orchestrator.py - Council Orchestrator → Remediation Planner: plans remediation
agents/orchestrator.py - Council Orchestrator → Safety Guardian: gates agents
agents/orchestrator.py - Council Orchestrator → Sandbox Executor: executes approval
agents/orchestrator.py - Root Cause Analysis → Hybrid Retrieval: retrieves evidence
agents/agent1_rca/analyzer.py - Remediation Planner → Hybrid Retrieval: retrieves evidence
agents/agent3_planner/planner.py - Hybrid Retrieval → Keyword Index: searches lexical
rag/hybrid_engine.py - Hybrid Retrieval → Vector Index: searches dense
rag/hybrid_engine.py - Sandbox Executor → Managed Backend: tests remediation
- Council Orchestrator → Evolution Learner: updates ranking
agents/orchestrator.py - Evolution Learner → Outcome Memory: learns outcomes
agents/agent6_evo/policy_learner.py - Operator / Client → System DNA Capsule: requests recovery
- System DNA Capsule → Genesis Restore: restores from
capsule/genesis_engine.py - Managed Backend → Backend Database: uses database
target_system/demo_app/server.py - Umbrella SDK → Control Dashboard: submits incident