Skip to content

docs(expo): open the verify PR as a draft until the evidence is in - #10620

Merged
mikepitre merged 3 commits into
mainfrom
verify-draft-until-evidence
Nov 3, 2026
Merged

mikepitre merged 3 commits into
mainfrom
verify-draft-until-evidence

Conversation

@mikepitre

@mikepitre mikepitre commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

Description

The verify-clerk-expo skill now has the agent open its pull request as a draft with gh pr create --draft, run attach and down, and only then run gh pr ready <n>. For a remote session, where the evidence reaches the description about a minute after down, it first checks that gh pr view <n> --json body shows the verify-evidence block. references/remote.md says the same.

Why: review bots such as CodeRabbit review a pull request when it opens or turns ready, and read the description as it is then. The skill had the agent open the PR ready and attach right after, so the first review could miss the evidence. On clerk/clerk-ios#805 the evidence landed 16 seconds after the PR opened, and CodeRabbit's device evidence check failed on the earlier description. This repo's CI also skips drafts, so it starts once the PR turns ready. Same change as the clerk-ios and clerk-android skills.

In a Claude Code cloud session GitHub's GraphQL API is blocked, so gh pr create, gh pr view and gh pr ready fail there. The skill names the REST forms that work, including POST repos/clerk/javascript/pulls/<n>/ccr/ready_for_review, which a cloud session confirmed on a clerk-ios test PR. The wait for the evidence polls the description over REST for the table row and gives up after ten minutes.

Docs only.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

🤖 Generated with Claude Code

CodeRabbit reviews a PR when it opens or turns ready and judges the
description it reads then. A PR opened ready was reviewed before attach
wrote the evidence, so its device evidence check failed (clerk-ios#805).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 0707343

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel

vercel Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
clerk-js-sandbox Ready Ready Preview Nov 3, 2026 9:34pm UTC
swingset Ready Ready Preview Nov 3, 2026 9:34pm UTC

Request Review

@coderabbitai

coderabbitai Bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

Caution

Review failed

The pull request is closed.

Walkthrough

The verification instructions now direct users to create a draft pull request, attach before-and-after evidence, run down, and check for the verify-evidence table before marking the pull request ready. They also note that review bots may review when a pull request opens or becomes ready. A changeset file gains an empty front-matter block.

Estimated code review effort: 2 (Simple) | ~8 minutes

Possibly related PRs

  • clerk/javascript#10400: Updates evidence publication to use one combined table, which this change checks before marking the pull request ready.
  • clerk/javascript#10556: Updates the Expo E2E evidence source and trace path used in the same run-and-attach workflow.
  • clerk/javascript#10576: Updates the verify-clerk-expo workflow and related E2E run and evidence instructions.
Merge Risk: Low · up to 07073

This docs-only change makes verification PRs open as drafts and become ready only after the evidence table appears. The remaining note is that marking the PR ready is an automatic step with no confirmation, a deliberate tradeoff for unattended runs. It is bounded and does not block merge.

Pre-merge checks: Passed 5
Check name Status Explanation
Title check Passed The title names the main change: the verify-clerk-expo skill now opens the verify PR as a draft until the evidence is attached. It uses the docs(expo) prefix, which matches the documentation-only chan…
Description check Passed The description matches the changeset. It explains that the verify-clerk-expo skill now opens PRs as drafts with gh pr create --draft, runs attach and down, and then runs gh pr ready. It also says ref…
Docstring Coverage Passed No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentat…
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.
Full details: Title check

Explanation

The title names the main change: the verify-clerk-expo skill now opens the verify PR as a draft until the evidence is attached. It uses the docs(expo) prefix, which matches the documentation-only change. The title is specific and matches the changeset, which edits the skill docs and changeset front-matter.

Full details: Description check

Explanation

The description matches the changeset. It explains that the verify-clerk-expo skill now opens PRs as drafts with gh pr create --draft, runs attach and down, and then runs gh pr ready. It also says references/remote.md was updated to match, which the raw summary confirms. The rationale is given, and the description is specific about the change.

Full details: Docstring Coverage

Explanation

No eligible functions found in the changed files. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff with cyclomatic complexity of at least 2. Documentation-only edits and deletions within surviving functions are included; unchanged diff context and fully deleted functions are excluded. Analyzed 0 functions across 0 files. (3 skipped: 3 unsupported.)

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Warning

Linked repositories: Some configured repositories could not be included in this review. Cross-repository analysis may be incomplete. Please check linked-repository access and settings.

CodeRabbit Verify

  • Run CodeRabbit Verify to test the changes in this pull request.
Recent review info
Run configuration
  • Source mode: Auto
  • Repository: clerk/javascript
  • Branch: main
  • File: .coderabbit.yaml
  • Commit: b0d7c00
  • Layers: Repository YAML (base), Organization UI (inherited)
  • Review profile: ASSERTIVE
  • Plan: Team
  • Run ID: 4b5a741d-6170-4232-83d4-fae49fe24b90
Commits

Reviewing files that changed from the base of the PR and between b0d7c00 and 414b4c0.

Files selected for processing: 3
  • .changeset/expo-verify-draft-until-evidence.md
  • .claude/skills/verify-clerk-expo/SKILL.md
  • .claude/skills/verify-clerk-expo/references/remote.md
Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

Included review availability: This review used your included allowance. 1 included review remains after this review. Your included PR review attempts over the past 7 days set your current allowance at 5 reviews per hour.

@pkg-pr-new

pkg-pr-new Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@10620

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@10620

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@10620

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@10620

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@10620

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@10620

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@10620

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@10620

@clerk/expo-biometrics

npm i https://pkg.pr.new/@clerk/expo-biometrics@10620

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@10620

@clerk/expo-native-components

npm i https://pkg.pr.new/@clerk/expo-native-components@10620

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@10620

@clerk/express

npm i https://pkg.pr.new/@clerk/express@10620

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@10620

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@10620

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@10620

@clerk/mosaic

npm i https://pkg.pr.new/@clerk/mosaic@10620

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@10620

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@10620

@clerk/react

npm i https://pkg.pr.new/@clerk/react@10620

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@10620

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@10620

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@10620

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@10620

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@10620

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@10620

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@10620

commit: 0707343

@coderabbitai coderabbitai 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.

  • Fix comments: Fix CodeRabbit comments on this PR

…uence

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…before ready

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

@wobsoriano wobsoriano 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.

🧪

@mikepitre
mikepitre merged commit 86bdfb5 into main Nov 3, 2026
56 of 57 checks passed
@mikepitre
mikepitre deleted the verify-draft-until-evidence branch November 3, 2026 21:39

This branch was successfully deployed

2 active deployments
Preview – swingset — 07073438 Deployed Nov 3, 2026 by vercel[bot]
Preview – clerk-js-sandbox — 07073438 Deployed Nov 3, 2026 by vercel[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