Skip to content

fix(lint): keep agent worktrees out of Biome's scope - #615

Merged
goosewobbler merged 1 commit into
mainfrom
fix/biome-ignore-agent-worktrees
Aug 1, 2026
Merged

goosewobbler merged 1 commit into
mainfrom
fix/biome-ignore-agent-worktrees

Conversation

@goosewobbler

@goosewobbler goosewobbler commented Aug 1, 2026 •

Copy link
Copy Markdown
Owner

Agent worktrees under .claude/worktrees/ are full checkouts, each carrying its own root biome.jsonc. Biome refuses to run at all when it discovers a nested root config, so a single leftover worktree broke pnpm lint for the whole repo:

× Found a nested root configuration, but there's already a root configuration.
× Biome exited because the configuration resulted in errors.

The error points at the config rather than the worktree, which makes it awkward to attribute — and it only shows up when a worktree happens to exist, so it comes and goes.

Gitignoring them isn't enough: vcs.useIgnoreFile is off, so Biome never reads .gitignore (where .claude/worktrees/ is already listed). Excluding the directory in files.includes is what actually takes it out of scope.

Verification

With a worktree present, pnpm lint exits 1 without this change and 0 with it — checked both directions against the same worktree rather than just confirming the happy path.

Repo-wide pnpm lint is green (462 files, 29 warnings, exit 0). Those warnings are pre-existing and non-failing (13 noNonNullAssertion, 6 noUndeclaredEnvVars, and a scattering of others); left alone here, happy to clear them separately if you want them gone.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FADRmu9uhtCk3StMoqwV27

Greptile Summary

This PR prevents agent worktrees from breaking repository-wide Biome runs.

  • Excludes .claude directories from Biome file discovery.
  • Documents why Git ignore handling alone does not prevent nested root configuration errors.

Confidence Score: 5/5

The PR appears safe to merge with no actionable defects identified.

The new exclusion prevents Biome from traversing nested agent worktrees, and the repository currently contains no tracked .claude files whose lint coverage would be lost.

Important Files Changed

Filename Overview
biome.jsonc Adds a correctly scoped Biome exclusion for agent worktrees, with no current tracked repository files unintentionally removed from lint coverage.

Reviews (1): Last reviewed commit: "fix(lint): keep agent worktrees out of B..." | Re-trigger Greptile

Agent worktrees under .claude/worktrees/ are full checkouts, each carrying its own
root biome.jsonc. Biome refuses to run at all when it discovers a nested root
config, so a single leftover worktree broke `pnpm lint` for the whole repo with an
error that points at the config rather than the worktree.

Gitignoring them isn't enough — vcs.useIgnoreFile is off, so Biome doesn't read
.gitignore. Excluding the directory in files.includes is what actually takes it out
of scope.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FADRmu9uhtCk3StMoqwV27
@github-actions

github-actions Bot commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

Standing release PR: #614 · v0.42.0 queued (4 packages) · open 26m · ✅ ready to merge

Release Preview — v0.41.2 → v0.41.3

Note: Labels on this PR are advisory in standing-pr mode. Bumps come from conventional commits in the standing PR; override by editing labels on the standing PR itself. Add release:immediate to bypass the standing PR and release this PR directly.

These changes will be added to the release PR (#614) when merged:

Changelog

monorepo 0.41.2 → 0.41.3

Fixed

  • keep agent worktrees out of Biome's scope (lint)

All packages → 0.41.3 (sync versioning)

  • @releasekit/version
  • @releasekit/notes
  • @releasekit/publish
  • @releasekit/release

After merge — predicted release

No version escalation — this PR's changes will be included in the queued release without affecting the projected versions.

Package Standing PR This PR After merge
monorepo 0.42.0 0.41.3 0.42.0

Updated automatically by ReleaseKit

@goosewobbler
goosewobbler merged commit 89a9904 into main Aug 1, 2026
18 checks passed
@goosewobbler
goosewobbler deleted the fix/biome-ignore-agent-worktrees branch August 1, 2026 18:36
@github-actions github-actions Bot mentioned this pull request Aug 1, 2026
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