Skip to content

docs: document the INDEX_REBUILDING retryable 503 (harper#1363) - #532

Merged
kriszyp merged 2 commits into
mainfrom
docs/index-rebuilding-error
Jun 18, 2026
Merged

kriszyp merged 2 commits into
mainfrom
docs/index-rebuilding-error

Conversation

@heskew

@heskew heskew commented Jun 18, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Documents the typed, retryable 503 (code: INDEX_REBUILDING, retryable: true) a query returns when its target secondary index is still (re)building — introduced in HarperFast/harper#1363 (part of #1354). Adds a subsection to the Query Optimization reference with the response shape and retry guidance.

Version

Shipped in v5.1.5 (published 2026-06-18; both #1363 and #1374 are in the release), so the <VersionBadge version="v5.1.5" /> is final.

Cross-link


🤖 Generated with Claude Code (Opus 4.8)

Querying an attribute whose secondary index is still (re)building now returns a
typed, retryable 503 (code INDEX_REBUILDING). Documents the response shape and
the retry guidance in the Query Optimization reference. See HarperFast/harper#1363.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds a new section to the query optimization documentation explaining how Harper handles queries on attributes whose secondary indexes are still building, detailing the 503 INDEX_REBUILDING transient error. The reviewer suggested formatting the error response details as a markdown table to improve readability and maintain consistency with the rest of the document.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread reference/resources/query-optimization.md Outdated
@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-532

This preview will update automatically when you push new commits.

@heskew
heskew marked this pull request as ready for review June 18, 2026 19:35
@heskew
heskew requested a review from a team as a code owner June 18, 2026 19:35
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

…able

Per review feedback (matches the operator table earlier in this doc). Values
backticked so the message's <attribute> placeholder isn't parsed as JSX in MDX.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@heskew
heskew requested a review from kriszyp June 18, 2026 19:49
@github-actions
github-actions Bot temporarily deployed to pr-532 June 18, 2026 19:50 Inactive
@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-532

This preview will update automatically when you push new commits.

@kriszyp kriszyp left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Accurate docs, verified against #1363. LGTM! 🟢

Reviewed by Claude Sonnet 4.6

@kriszyp
kriszyp merged commit 57ee6c0 into main Jun 18, 2026
7 checks passed
@kriszyp
kriszyp deleted the docs/index-rebuilding-error branch June 18, 2026 20:11
@github-actions

Copy link
Copy Markdown

🧹 Preview Cleanup

The preview deployment for this PR has been removed.

This branch was previously deployed

1 inactive deployment
pr-532 — 00087ba6 Deployed Jun 18, 2026 by github-actions[bot]
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.

2 participants