How neeraj-220622/hackwithhyderabad-agent works
This repository is an AI agent with an operational incident-response product: engineers submit alerts, receive memory-grounded diagnoses and fix warnings, then provide feedback or close incidents to retain learnings. The React interface also exposes memory inspection, patterns, comparison, evaluation, synthetic seeding, and resilience status. The incident service is the documented orchestrator; some feature implementations and agent internals were not sampled, so their internal wiring is shown only where the excerpts or README support it.
Main entry points: service.py Incident orchestrator · api.js API client · hindsight.py Hindsight wrapper · App.jsx Application shell
Components 22
React interface
- Application shell
frontend/src/App.jsx - Incident dashboard
frontend/src/components/IncidentDashboard.jsx - Memory and analysis views
frontend/src/components/MemoryInspectorView.jsx - API client
frontend/src/services/api.js
API and orchestration
- FastAPI app
backend/main.py - Agent routes
backend/api/agent_routes.py - Incident routes
backend/api/incident_routes.py - Health route
backend/api/routes.py
Incident response
- Incident orchestrator
backend/incident/service.py - Alert normalization
backend/incident/normalizer.py - Recall planning
backend/incident/recall_planner.py - Diagnosis
backend/incident/diagnosis.py - Fix analysis
backend/incident/fix_analyzer.py - Stale fix detection
backend/incident/stale_detector.py - Session incident store
backend/incident/service.py - Learning features
backend/incident
Agent services
- Agent core
backend/agent/agent.py - LLM service
backend/agent/llm.py - Hindsight wrapper
backend/memory/hindsight.py
Other components
- Engineer
- Groq API
- Hindsight server
Connections 28
- Engineer → Application shell: uses
- Application shell → Incident dashboard: renders
- Application shell → Memory and analysis views: renders
- Incident dashboard → API client: requests alerts
- Memory and analysis views → API client: requests features
- Application shell → API client: requests chat and memory
- API client → Incident routes: HTTP requests
- API client → Agent routes: HTTP requests
- FastAPI app → Agent routes: mounts
- FastAPI app → Incident routes: mounts
- FastAPI app → Health route: mounts
- Agent routes → Agent core: runs chat
- Agent routes → Hindsight wrapper: lists memories
- Agent core → LLM service: generates replies
- Agent core → Hindsight wrapper: recalls and retains
- LLM service → Groq API: calls provider
- Hindsight wrapper → Hindsight server: recalls and writes
- Incident routes → Incident orchestrator: dispatches operations
- Incident orchestrator → Alert normalization: normalizes alert
- Incident orchestrator → Recall planning: plans recall
- Incident orchestrator → Diagnosis: diagnoses alert
- Incident orchestrator → Fix analysis: analyzes fixes
- Incident orchestrator → Stale fix detection: checks stale fixes
- Incident orchestrator → Session incident store: stores and lists
- Incident orchestrator → Hindsight wrapper: recalls and retains
- Incident orchestrator → LLM service: requests diagnosis
- Incident orchestrator → Learning features: dispatches features
- Learning features → Hindsight wrapper: uses memory