swaroop494/helia

How swaroop494/helia works

Helia is a failure-guided pytest-generation and evaluation system for Python repositories. Users configure and launch runs through the CLI; the controller coordinates repository indexing, mutant sampling, test generation and execution, using feedback to guide later generation before evaluating held-out mutants. Results include triage, provenance and reports. The README documents these product stages and integrations, but the controller and several subsystem implementations were not excerpted, so their internal call structure is not asserted.

Main entry points: controller/__init__.py Experiment controller · cli.py Helia CLI · executor/__init__.py Docker executor · repo_index/__init__.py Repository index

Components 19

User interface

Helia CLI src/helia/cli.py
Run configuration src/helia/controller/config.py

Experiment control

Experiment controller src/helia/controller/__init__.py
Repository index src/helia/repo_index/__init__.py
Mutant sampling src/helia/mutants/__init__.py
Test generation src/helia/generator/__init__.py
Guidance policy src/helia/policy/__init__.py
Cached LLM src/helia/llm/__init__.py

Test execution

Docker executor src/helia/executor/__init__.py
Container worker src/helia/executor/worker.py
Baseline adapters src/helia/baselines/__init__.py
CoverUp import src/helia/baselines/__init__.py

Feedback analysis

Failure analysis src/helia/analysis/__init__.py
Original failure triage src/helia/analysis/triage.py
Fix verification src/helia/analysis/history.py

Contracts and results

Reports and plots src/helia/controller/report.py
Run persistence src/helia/io.py
Versioned records contracts/models.py

Other components

Researcher

Connections 20

Researcher → Helia CLI: runs commands README.md
Helia CLI → Run configuration: loads configuration src/helia/cli.py
Helia CLI → Experiment controller: launches runs src/helia/cli.py
Helia CLI → Repository index: builds index src/helia/cli.py
Helia CLI → Reports and plots: requests reports src/helia/cli.py
Helia CLI → Fix verification: verifies fixes src/helia/cli.py
Helia CLI → Docker executor: creates executor src/helia/cli.py
Experiment controller → Repository index: indexes source README.md
Experiment controller → Mutant sampling: samples mutants README.md
Experiment controller → Test generation: generates tests README.md
Experiment controller → Docker executor: evaluates tests README.md
Experiment controller → Guidance policy: guides generation README.md
Experiment controller → Cached LLM: requests generations README.md
Experiment controller → Baseline adapters: runs baseline arms README.md
Experiment controller → Failure analysis: learns from feedback README.md
Experiment controller → Original failure triage: triages failures README.md
Experiment controller → Reports and plots: produces reports README.md
Docker executor → Container worker: dispatches jobs src/helia/executor/__init__.py
Experiment controller → CoverUp import: imports baseline results README.md
Helia CLI → Fix verification: supplies execution evidence src/helia/cli.py

Drawn by GitDiagram on November 11, 2026 from the repository's file tree, README and source files. Read as Markdown ·