Skip to content

docs: mutations_before_rebuild is the floor of the rebuild threshold - #550

Merged
tae898 merged 1 commit into
mainfrom
docs/floor-mutations-before-rebuild
Oct 28, 2026
Merged

tae898 merged 1 commit into
mainfrom
docs/floor-mutations-before-rebuild

Conversation

@tae898

@tae898 tae898 commented Oct 28, 2026

Copy link
Copy Markdown

Closes #549

The published bindings docs called mutations_before_rebuild an override of the rebuild threshold and listed "a lower mutations_before_rebuild" as a 26.10.1 workaround. The engine treats it as a floor: computeRebuildThreshold returns max(mutationsBeforeRebuild, min(graph size x rebuildGraphRatio, maxPendingMutations)), read from the database configuration, at the 26.10.1 and 26.10.2 tags and on main. Past 500 vectors at the default ratio 0.2, lowering it changes nothing.

File Change
docs/guide/vectors.md Drops the wrong workaround; adds the formula, the defaults (100, 0.2, 50,000) and the ALTER DATABASE route for arcadedb.vectorIndex.rebuildGraphRatio (main c3af6d9028: 1,000 to 250 at 5,000 vectors), and points to get_stats()["effectiveMutationsThreshold"].
docs/api/database.md The parameter line says floor and links the guide section.
core.py docstring Same; removes the "typical ranges" that only hold below 500 to 4,000 vectors.

Same fix as ArcadeData/arcadedb-python#111 and #113. Pre-commit passes on the three files.

🤖 Generated with Claude Code

The engine computes max(mutationsBeforeRebuild, min(graph size x rebuildGraphRatio,
maxPendingMutations)) in 26.10.1, 26.10.2 and main (computeRebuildThreshold, read from the
database configuration), so the "override" wording and the 26.10.1 workaround "a lower
mutations_before_rebuild" were wrong past 500 vectors. The guide now gives the formula and the
ALTER DATABASE route for rebuildGraphRatio (main c3af6d9: 1,000 to 250 at 5,000 vectors).
Same fix as ArcadeData/arcadedb-python#111 and #113.

Closes #549

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tae898
tae898 merged commit d1ddab2 into main Oct 28, 2026
363 of 444 checks passed
@tae898
tae898 deleted the docs/floor-mutations-before-rebuild branch October 28, 2026 21:35
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.

bindings docs: mutations_before_rebuild is a floor, and the 26.10.1 workaround that lowers it does nothing

1 participant