Skip to content

chore: add a formatter - #27

Merged
github-actions[bot] merged 4 commits into
mainfrom
chore/add-a-formatter
Aug 29, 2026
Merged

chore: add a formatter#27
github-actions[bot] merged 4 commits into
mainfrom
chore/add-a-formatter

Conversation

@catomean

Copy link
Copy Markdown
Collaborator

3 of 30 repos had any formatter at all. This adds one here, and wires format:check into verify so it actually gates.

Why this repo's own style, and not a fleet standard

There was never a standard to restore. Measured across the fleet: excluding openclaw, ~28k single-quoted imports against ~15k double-quoted — and the two repos that already had a .prettierrc disagreed with each other (trailingComma: all vs es5, arrowParens: always vs avoid).

Forcing one quote style would rewrite every string in roughly half the fleet for no benefit. And by the test this whole exercise runs on — does the choice cross repo boundaries? — quote style does not. Nobody copies a file between repos expecting the quotes to match.

So singleQuote here was chosen by counting this repo's own imports. The uniformity that matters is that a gate exists everywhere, not that the gate says the same thing everywhere.

What is deliberately out of scope

  • Markdown. Prettier rewraps prose, which is where it is most opinionated and least useful, and it would bury the real diff. One line in .prettierignore turns it on later.
  • Lockfiles and build output, for the obvious reason.

Reading the diff

Three commits, on purpose:

  1. config, ignore file, scripts
  2. the reformat — mechanical, no behaviour change
  3. .git-blame-ignore-revs listing commit 2

Run git config blame.ignoreRevsFile .git-blame-ignore-revs once and git blame will skip straight past the reformat.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UvjGNAS9CMfEGNW26tUR4P

catomean and others added 4 commits August 29, 2026 12:09
singleQuote=true was chosen by counting this repo's own
imports, not by fleet decree. The fleet is genuinely split and the two repos
that already had a .prettierrc disagreed with each other, so there was no
standard to restore. Quote style does not cross repo boundaries; having a
gate does.

Markdown is ignored for now — prettier rewraps prose, which would bury the
real diff.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Mechanical. No behaviour change. This SHA is listed in
.git-blame-ignore-revs so `git blame` skips it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
eslint-disable-next-line binds to a line number, so reformatting can silently
break it. This effect was written on one line:

  // eslint-disable-next-line react-hooks/set-state-in-effect
  useEffect(() => { setMounted(true); }, []);

prettier expanded it to a block body, which moved setMounted(true) down a line
and out from under the directive. The rule reports at the setState call, not at
the useEffect, so the suppression stopped applying and the build failed on a
rule the author had deliberately silenced.

Moving the directive inside the effect binds it to the call itself, where
reflowing cannot separate them. The other six directives in src/ still bind.
@github-actions
github-actions Bot merged commit dae6e35 into main Aug 29, 2026
1 check passed
@github-actions
github-actions Bot deleted the chore/add-a-formatter branch August 29, 2026 11:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant