Skip to content

docs: add README limits and status section - #28

Merged
mattmattox merged 2 commits into
mainfrom
claude/docs-limits-status
Oct 24, 2026
Merged

mattmattox merged 2 commits into
mainfrom
claude/docs-limits-status

Conversation

@mattmattox

Copy link
Copy Markdown
Contributor

Adds a "Limits and Status" section to the README, points CLAUDE.md Commands Config at make test-unit and make lint, and drops the dead ^main\.go$ lint exclusion.

Lookup timing was measured on 28fed6f (172.25.1.68, one node, ZFS-backed image): about 25 ms per lookup even in a 10-file directory, 47 s for ls -l of 1,000 files. The cost is per lookup, not per entry, because each lookup reads the full 1 MB directory block.

The snapshot line points to CHANGELOG upgrade notes, so it stays true whether or not #16 lands. Also removes CLAUDE.md's stale two-extent limit (#8). make lint: 0 issues.

🤖 Generated with Claude Code

mattmattox and others added 2 commits October 24, 2026 15:49
Lists what users hit first: Linux only, 1 MB minimum per file with SFB
disabled, slow name lookups (measured on current main), format v2,
all-node upgrades, experimental snapshots and fsck, and links to the
cluster safety limits in docs/OPERATIONS.md.

CLAUDE.md: Commands Config now uses make test-unit and make lint, and
the stale two-extent limit is gone since the overflow tree landed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mattmattox
mattmattox merged commit 51f86a0 into main Oct 24, 2026
8 checks passed
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