Gravekeeper: a Día de los Muertos cemetery for dead code

说明与用途

Gravekeeper 为已删除代码创建离线墓园，提取 Git 历史并使用 Gemini 生成纪念卡片。

问题

Repositories accumulate dead code—files, exports, and dependencies that are never used—yet developers lack a systematic way to document and honor the removal of such code.

结果

Gravekeeper produces a visual, offline cemetery of dead code and a markdown memorial that records the lifecycle and removal rationale of each dead file, enabling transparent maintenance and historical insight.

工作流

• Run node src/index.ts scan <repo> to collect dead files using knip and git forensics.
• Run node src/index.ts write <repo> to send batches of dead-file records to Gemini and receive strict JSON epitaphs.
• Run node src/index.ts render <repo> to combine census and epitaphs into a self‑contained HTML cemetery and a graveyard.md file.
• Open the generated graveyard.html locally to view the cemetery.
• Commit graveyard.md alongside a removal PR to preserve the removal rationale.

证据

Gravekeeper calls them what they are — the dead — and gives them the send‑off the calendar demands.

来源

Three rites, three commands, against any JS/TS repo: ...

来源

The result is a candlelit cemetery you can walk through in the browser — tombstone cards, candle glow, marigold palette — plus a graveyard.md you can commit next to the removal PR, so the reason those lines are gone never evaporates with the conversation that decided it.

来源