8000 docs(spec): :limit, :offset and :order-by (#306) by adityamukho · Pull Request #729 · project-minigraf/minigraf · GitHub
[go: up one dir, main page]

Skip to content

docs(spec): :limit, :offset and :order-by (#306) - #729

Merged
adityamukho merged 3 commits into
v3from
feat/306-limit
Oct 24, 2026
Merged

adityamukho merged 3 commits into
v3from
feat/306-limit

Conversation

@adityamukho
Copy link
Copy Markdown
Collaborator

Design spec for #306: docs/superpowers/specs/2026-10-24-limit-order-by-design.md.

Decisions (approved 2026-10-24):

  1. :order-by added, with a Sort operator keeping the top offset + limit rows under a :limit.
  2. :limit without :order-by returns any n rows of the answer and stops pulling early; the one documented exception to plan-independent answers (always a sub-bag).
  3. :offset without :order-by is rejected at parse (PRS-116).
  4. :order-by names :find elements, aggregates and windows included; ties broken by the remaining :find columns (value_order), so ordered results are fully determined.

New codes PRS-115–118; no format, WAL or public-API change. Delivery: PR 1 :limit, PR 2 :order-by/:offset + docs site. Includes the 10M-fact :limit acceptance test moved from #473.

Reviewed with Codex; its four findings (typed slot resolution, verifier tokens/witnesses, early-stop scope under blocking operators, keep = 0) are fixed in the second commit.

Part of #306 (stays open until PR 2).

🤖 Generated with Claude Code

https://claude.ai/code/session_0169pNQsLcCEn48te9X9WuZW

adityamukho and others added 3 commits October 24, 2026 09:25
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0169pNQsLcCEn48te9X9WuZW
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0169pNQsLcCEn48te9X9WuZW
@adityamukho
adityamukho merged commit 18fe995 into v3 Oct 24, 2026
18 checks passed
@adityamukho
adityamukho deleted the feat/306-limit branch October 24, 2026 04:00
@codecov
codecov Bot commented Oct 24, 2026
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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