Exorcist: I made the ghosts of legacy Java code explain themselves (and tried to stop them lying)

Описание и применение

Exorcist автоматически определяет автора каждого класса в репозитории Java, генерирует объяснения, выявляет дефекты кода и предлагает безопасные рефакторинги, сохраняя все операции локально.

Задача

Legacy Java codebases contain hidden code smells and undocumented decisions that are hard to discover and refactor.

Результат

Exorcist can read a Git repo, identify the main author per class, generate first‑person explanations with line citations, list code smells, and produce safe refactor diffs—all locally, without writing to disk.

Рабочий процесс

• summon <repo> – list classes with ghost info
• possess <Class> – ghost explains class with line citations
• confess – ghost lists code smells with line numbers
• exorcise – ghost proposes refactoring as a diff
• epitaph – ASCII tombstone

Доказательства

Exorcist is a terminal app that reads a Git repository, works out who really wrote each Java class, and lets the ghost of its main author explain the class in first person, confess its sins line by line, and propose a refactoring as a diff.

Источник

Reading the whole history takes under five seconds

Источник

The first confess run invented an IOException in two items (with the right line numbers, wrong content) and repeated one sin twice.

Источник

The first exorcise produced a diff that doesn't compile.

Источник