Skip to content

fix: adopt upstream mirror spec, break the format/drift loop, harden … - #119

Merged
Jexsie merged 3 commits into
mainfrom
fix-formatting
Jul 14, 2026
Merged

fix: adopt upstream mirror spec, break the format/drift loop, harden …#119
Jexsie merged 3 commits into
mainfrom
fix-formatting

Conversation

@exploreriii

Copy link
Copy Markdown
Contributor

Fixes #117
Fixes #118

The spec api-line drift in #117 was 99% formatting noise: parsed and compared structurally, the real change is one new field (AccountInfo.delegation_address — already in our types) plus nullability corrections. Spec refreshed byte-for-byte with the new fields, SNAPSHOT → 1e188c0.

Root cause fixed: the drift watcher byte-diffs the vendored spec, but prettier wasn't ignoring it — every pnpm format manufactured fake drift. The vendored spec is now in .prettierignore.

Also: the weekly canary (#118) failed on a transient mirror slow spell, not drift — it now uses timeoutMs: 30_000 so it alerts on real problems, not one slow day. Plus pre-existing prettier debt cleaned (config.yml had unquoted :emoji: YAML, three files unformatted).

…the weekly canary

Signed-off-by: exploreriii <133720349+exploreriii@users.noreply.github.com>
@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown

Coverage Report for core / integration (./packages/core)

Status Category Percentage Covered / Total
🔵 Lines 71.4% 1511 / 2116
🔵 Statements 71.37% 1541 / 2159
🔵 Functions 89.5% 486 / 543
🔵 Branches 58.36% 949 / 1626
File CoverageNo changed files found.
Generated in workflow #295 for commit c6c8636 by the Vitest Coverage Report Action

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown

Coverage Report for core / unit (./packages/core)

Status Category Percentage Covered / Total
🔵 Lines 95.65% (🎯 90%) 2024 / 2116
🔵 Statements 95.59% (🎯 90%) 2064 / 2159
🔵 Functions 97.42% (🎯 90%) 529 / 543
🔵 Branches 93.05% (🎯 90%) 1513 / 1626
File CoverageNo changed files found.
Generated in workflow #295 for commit c6c8636 by the Vitest Coverage Report Action

@github-actions

github-actions Bot commented Jul 13, 2026

Copy link
Copy Markdown

Coverage Report for mirror / unit (./packages/mirror)

Status Category Percentage Covered / Total
🔵 Lines 100% (🎯 90%) 471 / 471
🔵 Statements 99.79% (🎯 90%) 484 / 485
🔵 Functions 100% (🎯 90%) 237 / 237
🔵 Branches 94.65% (🎯 90%) 248 / 262
File CoverageNo changed files found.
Generated in workflow #295 for commit c6c8636 by the Vitest Coverage Report Action

Signed-off-by: exploreriii <133720349+exploreriii@users.noreply.github.com>
@coderabbitai

coderabbitai Bot commented Jul 13, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

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

Next review available in: 49 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 44c906fd-fbfd-40bd-86eb-6109187cf7c2

📥 Commits

Reviewing files that changed from the base of the PR and between 0b02b0a and c6c8636.

📒 Files selected for processing (2)
  • .github/ISSUE_TEMPLATE/bug.yml
  • packages/core/test/integration/topic/queries/TopicMessageQuery.spec.ts

Walkthrough

Changes

The PR improves topic message integration-test diagnostics and timeout handling, updates mirror specification metadata and example timeout configuration, and normalizes GitHub issue-template YAML formatting.

Topic delivery integration tests

Layer / File(s) Summary
Delivery timeout and diagnostics
packages/core/test/integration/topic/queries/TopicMessageQuery.spec.ts
Integration tests use longer test timeouts, subscription retries, stream error capture, diagnostic delivery waits, and retained unsubscribe assertions.

Mirror metadata and example configuration

Layer / File(s) Summary
Vendored specification tracking
.prettierignore, packages/mirror/spec/SNAPSHOT
The vendored OpenAPI file is excluded from formatting, and the snapshot reference is updated.
Mainnet example timeout
samples/examples/src/mirror/queries.ts, samples/examples/tsconfig.json
The mirror example uses a 30-second client timeout, with its TypeScript include list reformatted.

Issue template formatting

Layer / File(s) Summary
Issue template YAML normalization
.github/ISSUE_TEMPLATE/*
Bug, feature, and issue configuration templates receive whitespace, indentation, quoting, and label-formatting normalization without content changes.
🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (1 warning, 1 inconclusive)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning The PR includes unrelated TopicMessageQuery.spec.ts changes and formatting-only edits outside the mirror spec and timeout objectives. Move unrelated test and formatting cleanup to a separate PR unless they are needed for the linked mirror spec and canary fixes.
Linked Issues check ❓ Inconclusive [#118] is addressed by the 30s timeout, but [#117] can't be fully verified because packages/mirror/spec/openapi.yml was excluded by !packages/mirror/spec/openapi.yml and coverage changes aren't shown. Provide reviewable evidence for the vendored spec refresh and coverage-manifest/test updates, or include packages/mirror/spec/openapi.yml in review.
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly reflects the main change: upstream mirror spec adoption plus drift-loop and timeout hardening.
Description check ✅ Passed The description is directly about the spec refresh, drift fix, and canary timeout changes in the PR.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix-formatting

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.

@exploreriii
exploreriii marked this pull request as ready for review July 13, 2026 13:10
Copilot AI review requested due to automatic review settings July 13, 2026 13:10

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

Pull request overview

This PR updates the repo’s mirror-node integration to align with the latest upstream OpenAPI snapshot, reduces recurring “spec drift” noise caused by formatting, and hardens CI-facing canaries/tests against transient mirror slowness.

Changes:

  • Ignore the vendored mirror OpenAPI spec in Prettier to prevent format-induced spec drift, and update the tracked upstream snapshot reference.
  • Increase the public-mainnet examples canary timeout to reduce false failures from slow mirror responses.
  • Harden TopicMessageQuery integration tests with longer time budgets, extra subscription retries, and improved diagnostics.

Reviewed changes

Copilot reviewed 7 out of 9 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
samples/examples/tsconfig.json Prettier-style formatting only.
samples/examples/src/mirror/queries.ts Increases mirror client timeout for the weekly public-mainnet canary example.
packages/mirror/spec/SNAPSHOT Updates the recorded upstream spec snapshot identifier.
packages/core/test/integration/topic/queries/TopicMessageQuery.spec.ts Adds longer test timeouts, increased subscribe retries, and new delivery-wait diagnostics.
.prettierignore Ignores vendored packages/mirror/spec/openapi.yml to prevent format drift.
.github/ISSUE_TEMPLATE/feature.yml Reformatting of issue template YAML.
.github/ISSUE_TEMPLATE/config.yml Quotes emoji-like strings in YAML and reformats.
.github/ISSUE_TEMPLATE/bug.yml Reformats YAML; also contains a few text issues (typos/URL) needing fixes.

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

Comment thread .github/ISSUE_TEMPLATE/bug.yml Outdated
Comment thread .github/ISSUE_TEMPLATE/bug.yml Outdated
Comment thread .github/ISSUE_TEMPLATE/bug.yml Outdated
Copilot AI review requested due to automatic review settings July 13, 2026 13:15

@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: 1


ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 26489c8d-6a21-468e-b684-e5771a3951b8

📥 Commits

Reviewing files that changed from the base of the PR and between 920ecdd and 0b02b0a.

⛔ Files ignored due to path filters (1)
  • packages/mirror/spec/openapi.yml is excluded by !packages/mirror/spec/openapi.yml
📒 Files selected for processing (8)
  • .github/ISSUE_TEMPLATE/bug.yml
  • .github/ISSUE_TEMPLATE/config.yml
  • .github/ISSUE_TEMPLATE/feature.yml
  • .prettierignore
  • packages/core/test/integration/topic/queries/TopicMessageQuery.spec.ts
  • packages/mirror/spec/SNAPSHOT
  • samples/examples/src/mirror/queries.ts
  • samples/examples/tsconfig.json

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

Pull request overview

Copilot reviewed 8 out of 9 changed files in this pull request and generated 6 comments.

Comment thread .github/ISSUE_TEMPLATE/bug.yml
Comment thread .github/ISSUE_TEMPLATE/bug.yml
Signed-off-by: exploreriii <133720349+exploreriii@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 13, 2026 13:21

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

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

@exploreriii
exploreriii requested a review from Jexsie July 13, 2026 14:03
@Jexsie
Jexsie merged commit 9f87aab into main Jul 14, 2026
8 of 10 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.

Mainnet mirror smoke failure Mirror node OpenAPI spec drift detected

3 participants