Skip to content

chore: add a formatter - #233

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

chore: add a formatter#233
github-actions[bot] merged 5 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 3 commits August 29, 2026 11:40
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>
@catomean
catomean force-pushed the chore/add-a-formatter branch from 10b039a to 6501152 Compare August 29, 2026 09:43
The formatter was added to the root package.json, but CI installs with
working-directory: frontend and then runs npm run verify at the root, so root
devDependencies are never installed at all. format:check died with
'prettier: not found' before checking a single file.

Root now delegates into frontend the way every other root script already does,
and prettier is a devDependency of frontend, whose lockfile CI installs.

frontend also needs its own .prettierignore: prettier resolves that file
relative to the working directory, so the root one stopped applying the moment
the command ran from frontend/ — which is how README.md and Playwright output
ended up being checked.
format:check ran green locally and failed in CI on files that do not exist
locally: CI builds contentlayer before verify, so .contentlayer/generated is
present by the time prettier looks. One generated module imports with
assert { type: 'json' }, which prettier's parser rejects outright.

A local --check cannot see build output, so generated directories have to be
ignored by name rather than discovered.
@github-actions
github-actions Bot merged commit 53d2e70 into main Aug 29, 2026
1 check passed
@github-actions
github-actions Bot deleted the chore/add-a-formatter branch August 29, 2026 11:06
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