null-as-error-cc

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.