Audit Stale Comments

Audit source comments against the code they describe. Report only confirmed mismatches and noise; do not edit files unless the user separately asks for fixes.

Scope

Accept zero or more file or directory paths. With no arguments, use the current repository root. Resolve every path from the current working directory and report any path that cannot be read.

Discover JavaScript, JSX, TypeScript, TSX, and Go source files. By default exclude:

• tests, testdata, fixtures, snapshots, and stories;
• generated, vendor, dependency, coverage, cache, and build-output directories;
• minified JavaScript and generated Go files.

An explicitly named test file or test directory overrides only the test exclusion. Generated, vendored, minified, and build-output files remain excluded unless the user explicitly requests them.