How rohithpranov07/helix works
HELIX is an autonomous maintenance layer for AI-built software: users connect a repository, then inspect its intent/code alignment, security findings, entropy, incidents, and repair activity in a web control plane. Its engine organs capture and pair intent, scan and heal vulnerabilities, validate repairs in a Shadow twin, track recurring fixes, measure entropy, handle incidents, and gate work by homeostasis. MongoDB stores the system’s biological memory and records; Groq and Gemini provide cognition and perception. The README documents n8n reflex arcs, but their runtime wiring is not present in the supplied tree.
Main entry points: src MongoDB · immune Immune System · genome Intent Genome · api API Routes
Components 22
Control Plane
- Dashboard
apps/web/app/dashboard - API Routes
apps/web/app/api - Vital Signs
apps/web/app/api/vitals/route.ts - Activity Stream
apps/web/app/api/stream/route.ts - GitHub Connect
apps/web/app/api/auth/github
Genome
- Genome Routes
apps/web/app/api/reflex - Intent Genome
packages/engine/src/genome
Repair Organs
- Immune Routes
apps/web/app/api/reflex - Immune System
packages/engine/src/immune - Immune Memory
packages/engine/src/memory - Shadow Verification
packages/engine/src/shadow
Operations
- Metabolism Routes
apps/web/app/api/metabolism-scan/route.ts - Metabolism
packages/engine/src/metabolism - Nervous System
packages/engine/src/nervous - Governor
packages/engine/src/governor
Shared Platform
- AI Clients
packages/ai/src - MongoDB
packages/db/src
Other components
- Engineer
- GitHub
- ShopLite Target
apps/target - Shadow Twin
- n8n Workflows
Connections 34
- Engineer → Dashboard: uses
- Dashboard → API Routes: requests
- API Routes → Genome Routes: dispatches
- API Routes → Immune Routes: dispatches
- API Routes → Metabolism Routes: dispatches
- Genome Routes → Intent Genome: calls
- Immune Routes → Immune System: calls
- Metabolism Routes → Metabolism: calls
- GitHub Connect → GitHub: authorizes
- GitHub Connect → Intent Genome: uses integration
- GitHub Connect → MongoDB: saves connection
- Intent Genome → GitHub: reads repository
- Intent Genome → MongoDB: stores strands
- Immune System → ShopLite Target: scans and patches
- Immune System → Shadow Verification: requests verification
- Shadow Verification → Shadow Twin: tests changes
- Shadow Verification → MongoDB: stores proofs
- Immune System → MongoDB: stores findings
- Immune System → Immune Memory: mints antibodies
- Immune Memory → MongoDB: stores antibodies
- Metabolism → MongoDB: stores measurements
- Nervous System → MongoDB: stores incidents
- Governor → MongoDB: stores homeostasis
- Intent Genome → AI Clients: requests pairing
- Metabolism → AI Clients: requests analysis
- Immune System → AI Clients: requests reasoning
- Nervous System → AI Clients: requests reasoning
- Vital Signs → MongoDB: reads organ records
- Vital Signs → Nervous System: fetches deploy data
- Activity Stream → MongoDB: polls activity records
- n8n Workflows → Immune Routes: triggers reflex arcs
- n8n Workflows → Metabolism Routes: triggers scheduled runs
- n8n Workflows → Nervous System: triggers reflex arcs
- n8n Workflows → Governor: triggers checks