repo-hygiene

Run find commands matching backup patterns like *.bak, *.orig, .DS_Store, and empty directories, excluding node_modules and target. Dead files are removed with git rm, while tracked generated files are added to .gitignore and untracked with git rm --cached.

Search for references to each script filename across package.json, README, CI workflows, and source directories. Scripts with zero references and no documentation are flagged for user decision rather than deleted automatically.

No, the audit never modifies source code logic. It only addresses repository structure, naming, configuration, and documentation, and all deletions require explicit user confirmation before execution.

Protected files include CI ratchet files like known-failures JSON, checked-in gate inputs, git submodules, generated fixture directories, PGO profiling data, and upstream issue indexes. These are shrink-only CI inputs or pinned corpus sources.

Use git rev-list --objects --all piped to git cat-file --batch-check to list blobs by size, then sort descending. Build artifacts like .wasm, .node, and platform binaries must not be tracked in the repository.