What problem does it solve?
Detects and prevents silent error swallowing in Effect-based TypeScript code where catchAll or Effect.ignore patterns collapse real failures into sentinel success values (null, [], false, void), making failures invisible to callers and hampering observability and debugging.
Core Features & Use Cases
- Fast static detection: A ripgrep-driven Bun scanner finds candidate catchAll and Effect.ignore patterns and emits structured JSON hits.
- Context enrichment & suppression handling: Each hit is enriched with surrounding context, enclosing function name, export status, and suppression marker detection to reduce false positives.
- Read-only auditor workflow: The skill spawns a read-only auditor agent that consumes the scanner output plus curated reference files to classify severity and recommend fixes.
- Report synthesis: Produces a final classified audit listing counts, severities, suppressed items, and a decision-linked summary table for remediation.
- Use cases: Pre-merge code audits, repository hygiene sweeps, and production safety reviews in Effect-enabled services.
Quick Start
Run the null-as-error scanner on the project's src/ directory and produce a classified audit report listing errors, warnings, suppressed occurrences, and recommended fixes.