Add pre-commit hook that runs fastlane autocorrect

[bgoncal]

Summary

Adds a checked-in pre-commit hook at .githooks/pre-commit that runs bundle exec fastlane autocorrect before every commit. The existing Podfile post_install block wires it up automatically (git config core.hooksPath .githooks), so every contributor running bundle exec pod install — already part of project setup — gets autocorrect on commit without any extra step.

How the hook behaves

1. Skip if SKIP_AUTOCORRECT=1 is set in the environment.
2. Skip if there are no staged changes (covers git commit --amend no-ops).
3. Snapshot the staged file list before doing anything, so the re-stage step can only ever touch files that were already part of the commit.
4. git stash push --keep-index --include-untracked so the working tree exactly matches the staged content. This means autocorrect runs against the tree being committed, not against in-progress edits.
5. Run bundle exec fastlane autocorrect.
6. Re-stage anything autocorrect modified — but only for files in the snapshot from step 3. Because step 4 left the working tree clean of unstaged work, the only diffs at this point are autocorrect's own changes. Partial-staged hunks (git add -p) are preserved.
7. A trap pops the stash on any exit path (success, autocorrect failure, interrupt). If git stash pop conflicts, the hook surfaces a warning pointing at the named stash so it can be resolved manually.

Setup

Automatic, via bundle exec pod install — the existing post_install block sets core.hooksPath = .githooks once. Idempotent and silent on subsequent runs. No extra step for new contributors.

Bypass

SKIP_AUTOCORRECT=1 git commit ...

For mid-rebase, machines without Pods installed, or any other escape hatch.

Files

• .githooks/pre-commit (new, executable)
• Podfile — add the core.hooksPath setup at the top of the existing post_install block
• README.md — one paragraph next to the existing fastlane autocorrect documentation

Addressed in review

• Snapshot staged files before autocorrect runs (was captured after — fixed)
• Don't break partial staging or sweep unrelated unstaged edits — the --keep-index stash dance now genuinely guarantees only autocorrect's changes are re-staged
• README wording matches the new behaviour precisely

Test plan

• bundle exec pod install configures core.hooksPath = .githooks on first run, silent on subsequent runs
• Commit a Swift file with intentional formatting issues — hook fixes and re-stages
• git add -p to stage partial hunks, then commit — hook preserves the unstaged hunks
• Commit while there are unstaged edits to other files — hook leaves those edits alone
• SKIP_AUTOCORRECT=1 git commit ... — bypasses without running autocorrect
• Commit a non-Swift, non-Ruby file — hook runs cleanly with no diff to re-stage

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds an opt-in, repo-tracked Git pre-commit hook to run bundle exec fastlane autocorrect automatically, with documentation so contributors can enable it via core.hooksPath.

Changes:

• Add .githooks/pre-commit to run fastlane autocorrect before commits and attempt to re-stage affected files.
• Document hook setup and bypass (SKIP_AUTOCORRECT=1) in README.md.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
README.md	Documents enabling the checked-in pre-commit hook and how it behaves/bypasses.
.githooks/pre-commit	Implements the pre-commit hook that runs autocorrect and re-stages files.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
⚠️ Please upload report for BASE (main@814152e). Learn more about missing BASE report.

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #4579   +/-   ##
=======================================
  Coverage        ?   43.24%           
=======================================
  Files           ?      275           
  Lines           ?    16700           
  Branches        ?        0           
=======================================
  Hits            ?     7222           
  Misses          ?     9478           
  Partials        ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.