8000 docs: link manual shape-sweep evidence and retention guidance (#841) by adityamukho · Pull Request #90 · project-minigraf/minigraf-docs · GitHub
[go: up one dir, main page]

Skip to content

docs: link manual shape-sweep evidence and retention guidance (#841) - #90

Merged
adityamukho merged 1 commit into
mainfrom
docs/841-shape-evidence
Nov 5, 2026
Merged

adityamukho merged 1 commit into
mainfrom
docs/841-shape-evidence

Conversation

@adityamukho
Copy link
Copy Markdown
Contributor

Companion to project-minigraf/minigraf#860 (Related project-minigraf/minigraf#841). Draft; not for merge without explicit approval.

All changes are wrapped in @since v3.0.0 blocks:

  • Performance Tuning: links the #841 report at its pinned commit (44e2d91c), and adds three tuning patterns without numbers, since numbers stay in BENCHMARKS:
    • a cursor or FactLog held across checkpoints keeps freed pages until the oldest reader is released, and the file does not shrink;
    • window state follows the largest partition, and incompatible window keys hold the whole input;
    • an unsatisfied :order-by under :limit keeps offset + limit rows.
  • Architecture: a cursor bounds the returned batch, not all retained query state.
  • Datalog reference: the :limit sort bound applies to the final sort's rows only.

No comparison or use-case change (no feature or target change). No site.toml entry, because there is no release.

Verified with a local build against a fresh core mirror holding all tags and branches: cargo run --release -- build --source-repo <mirror> → 13 versions, 368 pages, exit 0.

🤖 Generated with Claude Code

https://claude.ai/code/session_01H2a7QoYX6tc5G3sKVzvLjD

Links the pinned #841 report from Performance Tuning (v3.0.0+) with three
tuning patterns: held readers keep freed pages until the oldest is released,
window state follows the largest partition, and an unsatisfied :order-by
under :limit keeps offset + limit rows. Clarifies that a cursor bounds the
returned batch, not all retained query state.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01H2a7QoYX6tc5G3sKVzvLjD
@adityamukho
adityamukho marked this pull request as ready for review November 5, 2026 18:35
@adityamukho
adityamukho merged commit e1c59c6 into main Nov 5, 2026
2 checks passed
@adityamukho
adityamukho deleted the docs/841-shape-evidence branch November 5, 2026 18:36
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

0