What problem does it solve?
Prevents and repairs common continuous integration failures introduced by external code pushes or automated agents by removing unused imports/variables, surfacing TypeScript compilation errors, and reducing secret-scanner false positives so CI stays green and developer review is focused on meaningful changes.
Core Features & Use Cases
- ESLint unused variables: Automatically removes unused imports, prefixes unused destructured bindings with an underscore, and prefixes unused const/let declarations to satisfy @typescript-eslint/no-unused-vars and keep warnings under CI thresholds.
- Secret scanner false positives: Detects patterns in seed and module identifiers that trigger the repo's secret-scanner and documents or whitelists known false-positive patterns to avoid blocking CI.
- TypeScript reporting: Runs tsc to capture compilation errors and produces clear reports for manual fixes when automated remediation is insufficient.
- When to use: After git pulls/merges, when GitHub Actions fail, before pushing changes, or when collaborating with external agents that may introduce noisy changes.
- Workflow integration: Supports a post-pull standard workflow that auto-fixes, stages changes for review, and documents CI-related adjustments for maintainers.
Quick Start
Run the repository CI hygiene script to auto-fix lint warnings, surface TypeScript errors, and flag secret-scanner false positives.
