Skip to content

docs(bench): §9.23 asserting soak — enact rfc 0034 d1 recast, rfc 0035 green - #580

Merged
jensholdgaard merged 3 commits into
mainfrom
d1-arc-close
Jul 21, 2026
Merged

docs(bench): §9.23 asserting soak — enact rfc 0034 d1 recast, rfc 0035 green#580
jensholdgaard merged 3 commits into
mainfrom
d1-arc-close

Conversation

@jensholdgaard

@jensholdgaard jensholdgaard commented Jul 21, 2026

Copy link
Copy Markdown
Owner

What

The D1-arc closing set, on the §9.23 asserting run's evidence:

Doc-only; mdbook verified.

🤖 Generated with Claude Code

https://claude.ai/code/session_01WQY9wfrfRggqSpMLH8Xj3Y

Summary by CodeRabbit

  • Documentation
    • Updated ingest throughput guidance to use a per-node target as the primary success metric.
    • Clarified that legacy per-core and per-tenant figures are informational diagnostics only.
    • Added authoritative one-hour soak results, including throughput, latency, and backlog behavior.
    • Recorded completion of RFC 0034 acceptance criteria and resolved related open questions.
    • Marked RFC 0035 as green and documented completion of its Design A measurement criteria.

@jensholdgaard
jensholdgaard requested a review from Copilot July 21, 2026 01:25
@coderabbitai

coderabbitai Bot commented Jul 21, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

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

Next review available in: 43 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: e64d7d37-73f1-4a72-8f1f-0cb57407cd1f

📥 Commits

Reviewing files that changed from the base of the PR and between 5ce6669 and 3179cb8.

📒 Files selected for processing (3)
  • docs/benchmarks.md
  • docs/rfcs/0034-d1-rescope.md
  • docs/rfcs/0035-ingest-concurrency.md
📝 Walkthrough

Walkthrough

The changes recast D1 as a per-node throughput requirement, add an asserting soak record, and update RFC 0034 and RFC 0035 documentation to reflect enacted criteria, resolved questions, and green Design A status.

Changes

D1 benchmark and RFC status documentation

Layer / File(s) Summary
D1 benchmark criteria and asserting soak
docs/benchmarks.md
D1 now uses a per-node sustained throughput target, while prior per-core and per-tenant figures remain informational; §9.23 records the one-hour asserting soak and its results.
RFC 0034 enactment record
docs/rfcs/0034-d1-rescope.md
RFC 0034 documents the enacted D1 rescope, asserting-run relationship, tenant-count definition, and retained diagnostic wording.
RFC 0035 Design A status
docs/rfcs/0035-ingest-concurrency.md
RFC 0035 is marked green and records completed Design A measurements and criteria.
Estimated code review effort: 2 (Simple) ~10 minutes

Possibly related PRs

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description is missing the required Summary, Related, and Checklist sections from the repository template. Rewrite the PR description using the template headings and add a brief summary, related links/RFCs, and checklist status.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately reflects the main documentation changes: §9.23 soak evidence, D1 recast, and RFC 0035 green.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch d1-arc-close

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

Copilot AI 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.

Pull request overview

Updates the RFC/benchmark documentation to record the results of the §9.23 asserting soak and to reflect RFC 0034’s D1 recast and RFC 0035 meeting its acceptance criteria.

Changes:

  • Marks RFC 0035 as green and adds a status note tying its criteria to the in-repo suites and the §9.23 soak evidence.
  • Adds a status note to RFC 0034 documenting enactment/satisfaction state and resolves related open questions as completed.
  • Recasts docs/benchmarks.md D1 as a per-node bar (with per-core/ceiling retained as diagnostics) and adds the §9.23 results record.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File Description
docs/rfcs/0035-ingest-concurrency.md Updates RFC 0035 status to green, adds status note, and checks off the prototype measurement open question.
docs/rfcs/0034-d1-rescope.md Adds a status note documenting RFC0034.1 enactment and RFC0034.2 satisfaction; updates open-questions checklist.
docs/benchmarks.md Recasts D1 per-node with diagnostics retained; adds §9.23 authoritative asserting-soak results.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/rfcs/0035-ingest-concurrency.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/benchmarks.md`:
- Around line 326-332: Update the D1 benchmark acceptance wording in
docs/benchmarks.md to make the 100,000 lines/s requirement consistent with
§9.23: state that the run offers 100,000 lines/s and passes when achieved
throughput is at least 99% of offered, while preserving the existing latency
requirement and below-saturation qualification. Apply the same correction to the
corresponding acceptance text near §9.23.

In `@docs/rfcs/0035-ingest-concurrency.md`:
- Around line 361-364: Update the §6 measurement statement in the checklist to
limit the §9.22 result to clearing the red-stage throughput/capacity gate; do
not claim it cleared the full D1 must-win because its p99 latency criterion was
not established. If supported by the surrounding document, cite §9.23 for the
complete D1 result while preserving the benchmark figures.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 2717d0a0-0395-4c5c-ba0d-d8bb3b97ef32

📥 Commits

Reviewing files that changed from the base of the PR and between d2c622e and 5ce6669.

📒 Files selected for processing (3)
  • docs/benchmarks.md
  • docs/rfcs/0034-d1-rescope.md
  • docs/rfcs/0035-ingest-concurrency.md

Comment thread docs/benchmarks.md Outdated
Comment thread docs/rfcs/0035-ingest-concurrency.md Outdated
…ote, §9.22 scope

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WQY9wfrfRggqSpMLH8Xj3Y

Copilot AI 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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

Comment thread docs/benchmarks.md Outdated
…aude.md §3.7

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WQY9wfrfRggqSpMLH8Xj3Y

Copilot AI 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.

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

docs/benchmarks.md:313

  • The recast note claims the architecture “deliberately serializes” due to “per-tenant miner order” and cites CLAUDE.md §3.7, but §3.7 only states per-tenant scoping (template trees scoped per tenant) and does not describe an ordering/serialization requirement. This makes the rationale/citation inaccurate. Consider referencing the actual determinism / WAL-order-replay constraint (e.g., RFC 0001 §3.5.3) and keep CLAUDE.md §3.7 for scoping only.
> deliberately serializes twice (sequential per-tenant mining — the
> `CLAUDE.md` §3.7-scoped trees assign ids first-seen, which must

@jensholdgaard
jensholdgaard merged commit b32edbc into main Jul 21, 2026
24 of 25 checks passed
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