fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix(cli): await the next-steps outro so post-command output prints below it - #435

Merged
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue
Aug 21, 2026
Merged

fix(cli): await the next-steps outro so post-command output prints below it#435
rafa-thayto merged 3 commits into
mainfrom
rafa-thayto/slack-thread-fix-issue

Conversation

@rafa-thayto

Copy link
Copy Markdown
Contributor

Summary

Fixes the garbled "Update available" output reported in Slack: after clerk switch-env, the update notice printed on top of the "Next steps" block (Update available: 3.0.1 → 3.1.0henticate for this environment), with missing spaces, doubled backticks, and a stray duplicate "Next steps" header.

Root cause:outro(steps) in lib/spinner.ts is async — it awaits animateHeader, which parks the cursor on the header line for ~450ms of shine animation before restoring it. Several commands called outro(...) without await (a floating promise), so the command's promise resolved at the animation's first frame. Commander's postAction hook then ran maybeNotifyUpdate, whose lines printed at the parked cursor position — overwriting the step lines mid-block, while the animation's remaining frames repainted the header further down.

Fix:await every outro(...) call site (47 sites across 18 command files; deploy and webhooks token already awaited correctly). Output printed after a command now always lands below the finished block — the ordering .claude/rules/interrupts.md already documents as the post-command tail.

Test plan

  • New regression test switch-env/update-notice-race.test.ts runs the real spinner/gradient on a forced-interactive TTY, prints the update notice the instant switchEnv() resolves (exactly what postAction does), and asserts it lands after the animation's cursor-restore escape. Red before the fix (notice at stream index 606, cursor restored at 4377), green after. The assertion is enforced by promise sequencing, not wall-clock timing.
  • bun run format:check / lint / typecheck clean; full unit suite 2654 pass / 0 fail.
  • Changeset: clerk patch.

…low it
The next-steps outro animation moves the cursor back onto the header line
for ~450ms, but several commands (switch-env, auth logout, unlink,
users create, apps create, and others) did not await outro(). The command's
promise resolved mid-animation, so the postAction update check printed the
"Update available" notice at the parked cursor position — overwriting the
step lines and leaving a stray duplicate "Next steps" header.
Await every outro() call so output printed after a command lands below the
finished block. Adds a regression test that runs the real spinner/gradient
on a forced-interactive TTY and asserts the notice prints after the
animation's cursor-restore.
@changeset-bot

changeset-botBot commented Aug 21, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: fa65fd7

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

This PR includes changesets to release 1 package
NameType
clerkPatch

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

@coderabbitai

coderabbitaiBot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 671e13dc-38ab-416d-97e9-46a7cbe79c21

📥 Commits

Reviewing files that changed from the base of the PR and between 186689a and fa65fd7.

📒 Files selected for processing (1)
  • packages/cli-core/src/commands/switch-env/update-notice-race.test.ts
🔗 Linked repositories identified

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

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
  • clerk/javascript(auto-detected)

Included review availability: 6 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.


📝 Walkthrough

Walkthrough

CLI command exit paths now await asynchronous outro(...) operations across command areas. A regression test verifies update-notice ordering after switchEnv resolves. Version resolution now separates Bun macro fallback generation from CLI_VERSION handling and development-build classification. Changesets and versioning documentation were updated.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Merge Risk:⚪ Minimal · up to fa65f

This change ensures post-command update notices print after the completed Next steps block. No actionable merge-blocking risk remains beyond normal checks and review.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 9.38% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 32 functions across 21 files.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly and concisely describes the primary fix: awaiting the next-steps outro to prevent post-command output corruption.
Description check✅ PassedThe description accurately explains the update-notice race, the await fix, regression test, validation results, and changeset.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

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

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

LGTM! Looks like repeated applying of missed await to outro()

Consider a eslint or oxlint rule to catch this at compiler level

@wyattjoh
wyattjoh self-requested a review August 21, 2026 17:11
… Bun 1.4
Bun 1.4 runs macros in a sealed transpiler context that --define globals no
longer reach, so resolveVersionAtBuildTime() always took the checkout-derived
fallback and the compiled-version tests failed on CI (which floats to the
latest Bun satisfying engines).
Move the injected-vs-fallback choice and dev classification into version.ts
module scope, where define substitution still applies on every Bun version.
The macro now only derives the Git checkout fallback, so the compiled CLI
still never runs Git at runtime. Verified: version tests and the full suite
pass under both Bun 1.3.14 and 1.4.0.

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

Checked that the regression test genuinely goes red on the un-awaited code and green on the fix, and that the Bun 1.4 define change still resolves correctly on Bun 1.3.14 across all three build shapes (release define, no define, dev-flavored define). Two nits below; neither blocks.

Sent from Claude
  • reviewed by Wyatt Johnson

Comment threadpackages/cli-core/src/commands/switch-env/update-notice-race.test.ts Outdated
…e poll
On fixed code the animation completes before switchEnv() resolves, so the
700ms unconditional sleep was pure dead time on every green run. Poll for
the cursor-restore escape with a 2s bound instead: green runs return
immediately, and a regression still drains the orphaned animation so the
ordering assertion fails with its precise message.
@rafa-thayto
rafa-thayto merged commit 432ea9f into mainAug 21, 2026
11 checks passed
@rafa-thayto
rafa-thayto deleted the rafa-thayto/slack-thread-fix-issue branch August 21, 2026 17:33
@github-actionsgithub-actionsBot mentioned this pull request Aug 21, 2026
Sign up for freeto 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.

3 participants

@rafa-thayto@wyattjoh@thiskevinwang