Skip to content

docs: book chapter for the unified PathQuery - #802

Merged
QuantumExplorer merged 1 commit into
developfrom
claude/pathquery-book-chapter
Aug 19, 2026
Merged

docs: book chapter for the unified PathQuery#802
QuantumExplorer merged 1 commit into
developfrom
claude/pathquery-book-chapter

Conversation

@QuantumExplorer

Copy link
Copy Markdown
Member

Context

PR 7 — the final PR of the unified PathQuery effort (stacked on #801#800#799#798#797#795).

Adds The Unified PathQuery chapter to the mdBook, placed right after The Query System: read modes behind the Query encoding's version byte, the three read-mode shapes and their constructors, classify() as the one consensus-relevant shape decision, run_path_query / verify_path_query, both new V1 envelope layer kinds (axis descents with recomputed attestations, sum-budget windows with the verifier's fold replay), the GROVE_V4 gate table, and the relationship to the kept-first-class specialized surfaces. The Query System chapter gains a short pointer section.

mdbook build passes. Translations intentionally not touched (they lag by design; adding a chapter does not require translating it).

🤖 Generated with Claude Code

@coderabbitai

coderabbitai Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

@QuantumExplorer, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 3 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 9311ba3d-555d-4215-81c6-8801e5bac79f

📥 Commits

Reviewing files that changed from the base of the PR and between ba76763 and ed6eb81.

📒 Files selected for processing (3)
  • docs/book/src/SUMMARY.md
  • docs/book/src/query-system.md
  • docs/book/src/unified-path-query.md

Comment @coderabbitai help to get the list of available commands.

@QuantumExplorer
QuantumExplorer force-pushed the claude/pathquery-book-chapter branch from 729f7f6 to 643cc2c Compare August 14, 2026 01:39
@QuantumExplorer
QuantumExplorer force-pushed the claude/indexed-axis-versioning branch 2 times, most recently from c1091cd to b2d20b9 Compare August 14, 2026 11:50
@QuantumExplorer
QuantumExplorer force-pushed the claude/indexed-axis-versioning branch 4 times, most recently from 4500381 to 1dc44a1 Compare August 14, 2026 12:29
Base automatically changed from claude/indexed-axis-versioning to develop August 14, 2026 12:39
One chapter covering the whole unified surface: read modes (Axis /
SumBudget) behind the Query encoding's version byte, the three
read-mode shapes and their constructors, the classify() shape decision
shared by reader/prover/verifier, run_path_query and verify_path_query,
the two new V1 envelope layer kinds (axis descents with recomputed
attestations; sum-budget windows with the fold replay), the GROVE_V4
gate table, and how the specialized surfaces relate (all kept
first-class; chunk queries and read-mode merges deliberately out).

The Query System chapter gains a pointer section.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@QuantumExplorer
QuantumExplorer force-pushed the claude/pathquery-book-chapter branch from 643cc2c to ed6eb81 Compare August 14, 2026 14:44
@QuantumExplorer

Copy link
Copy Markdown
Member Author

This is Claude. Rebased onto develop (the branch was stacked on the pre-squash #801 head) and brought the chapter up to date with everything that merged since it was written:

  • TopKRankedPage with the directional top-k/bottom-k reading.
  • Tag 3 is AggregateOverValueRange { lo, hi, fold } — the chapter now carries the fold table (counts [3,1,5], band [2,10]: Population 2, Total 8), the entries-not-distinct-values note, and the fact that all four (axis, fold) cells are served since feat: dual-aggregate count secondary — count+Total served (closes #806) #809.
  • All secondaries are dual-aggregate PCPS, documented as a security requirement, not a convenience (per the feat: dual-aggregate count secondary — count+Total served (closes #806) #809 audit: the single-aggregate node hashes share a preimage layout).
  • Query-as-input, fold edition: the embedded descent payload carries no fold — dual-aggregate commitments mean one proof serves both questions, each verified against its own hash-bound number; the standalone envelopes echo and authenticate the fold instead. The chapter explains why the two wire paths differ here.
  • read_mode shown as Option<Box<ReadMode>>, constructor list updated (new_axis_aggregate_over_value_range, bottom_k).

mdbook build passes locally; the sum-budget and classify sections needed no changes (match_limit was already correct).

@QuantumExplorer
QuantumExplorer merged commit 6dfd973 into develop Aug 19, 2026
8 checks passed
@QuantumExplorer
QuantumExplorer deleted the claude/pathquery-book-chapter branch August 19, 2026 14:53
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