kova-test-heap-leaks

What problem does it solve?

This Skill helps you investigate suspected heap leaks or memory growth during Kova’s pnpm/Vitest test runs using heap snapshots, so you can distinguish real cleanup bugs from snapshot noise or shared-worker retained module graphs.

Core Features & Use Cases

• Reproduce with snapshot-friendly tracing: Guides you to run tests with KOVA_TEST_MEMORY_TRACE and scheduled heap snapshot collection to capture stable evidence over time.
• Compare heap snapshots deterministically: Uses heapsnapshot-delta.mjs to compare two snapshots directly or automatically choose earliest/latest per PID in a given lane directory.
• Triage by retained object families: Helps classify growth patterns (e.g., transformed-module retention vs runtime object/lifecycle leaks) and recommends how to validate conclusions with retainers/dominators.
• Produce actionable fixes: Translates dominant evidence into concrete next steps such as lane isolation, hotspot updates, singleton isolation, or test/runtime cleanup patches.

Quick Start

Run the reproduce command for your failing lane with heap snapshots enabled, then use the provided delta script to compare the earliest/latest snapshots for the same PID in the lane directory.