Skip to content

fix(fix-headers): never rewrite an existing @Author #16

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Shinrai merged 2 commits into from
Oct 4, 2026
Merged

fix(fix-headers): never rewrite an existing @Author #16

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c129e19
fix(fix-headers): never rewrite an existing @Author
Shinrai Oct 4, 2026
60ff285
fix(fix-headers): set forceAuthorUpdate to false explicitly
Shinrai Oct 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ Each file is exposed through `package.json` `exports`, so it resolves by its spe
"company": "CLDMV",
"companyName": "Catalyzed Motivation Inc.",
"copyrightStartYear": 2013,
"forceAuthorUpdate": true,
"forceAuthorUpdate": false,
"forceLastModifiedAuthorUpdate": true,
"fixCreatedDate": true,
"normalizeDateFormat": true,
Expand All @@ -122,13 +122,15 @@ Each file is exposed through `package.json` `exports`, so it resolves by its spe
| `company` | `"CLDMV"` | Write `@Author` as `Name <CLDMV>` |
| `companyName` | `"Catalyzed Motivation Inc."` | The copyright holder in `@Copyright`. fix-headers v2 has no built-in holder and otherwise reads it from the manifest author (`CLDMV`) |
| `copyrightStartYear` | `2013` | The first year of the `@Copyright` range, for every file |
| `forceAuthorUpdate` | `true` | Always rewrite `@Author` / `@Email` to the detected values |
| `forceAuthorUpdate` | `false` | Never rewrite an existing `@Author` / `@Email`; they record who created the file. A missing value is still filled in |
| `forceLastModifiedAuthorUpdate` | `true` | Always rewrite `@Last modified by` to the detected values |
| `fixCreatedDate` | `true` | Move an existing `@Date` back to the oldest of itself, the file's first git commit and its filesystem creation time |
| `normalizeDateFormat` | `true` | Write every header date in the git `%aI` form (`2026-03-01T17:59:32-08:00`) |
| `strictCreatedDate` | `true` | With `--check`, fail on an `@Date` later than the file's first commit or creation time instead of only warning |
| `margin` | `1` | One blank line between the header and the file's next content. The fix-headers default is two, which prettier collapses to one |

An existing `@Author` is never rewritten: it records who created the file, and this config sets `forceAuthorUpdate` to `false` explicitly so the decision is visible and wins over anything earlier in an `extends` chain. A repository can turn it on in its own config for a one-off migration of old author names.

The full description of every option is in the [fix-headers README](https://github.com/CLDMV/fix-headers#readme).

### Using it by URL
Expand Down
2 changes: 1 addition & 1 deletion fix-headers.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
"company": "CLDMV",
"companyName": "Catalyzed Motivation Inc.",
"copyrightStartYear": 2013,
"forceAuthorUpdate": true,
"forceAuthorUpdate": false,
"forceLastModifiedAuthorUpdate": true,
"fixCreatedDate": true,
"normalizeDateFormat": true,
Expand Down
Loading