Git Repo Normalize

Workflow

1. Detect the repository scope first.

   • Run git rev-parse --is-inside-work-tree and git rev-parse --show-toplevel.
   • Manage .gitattributes only at the repository root.

2. Normalize before doing other repository work.

   • Do not postpone line-ending normalization until the end of the task.
   • Treat the first Git-facing handling of a repo as the normalization point.
   • If the root .gitattributes does not contain * text=auto eol=lf, add or merge that rule instead of replacing the file.
   • Preserve existing user rules and binary file patterns.

3. Inspect the repo signals that explain LF/CRLF drift.

   • Read .editorconfig when present and check whether it already declares end_of_line = lf.
   • Read git config --get core.autocrlf to explain local warnings, but do not treat global Git config as the fix.
   • Use git ls-files --eol on representative files when the repository state is unclear.