fix: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould
, '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: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould
, '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: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould
, '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: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould
, '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: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould
, '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: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould
, '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: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould
, '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: resolve --file absolute paths in clerk env pull - #270

Merged
rafa-thayto merged 2 commits into
mainfrom
dull-shingle
May 11, 2026
Merged

fix: resolve --file absolute paths in clerk env pull#270
rafa-thayto merged 2 commits into
mainfrom
dull-shingle

Conversation

@rafa-thayto

@rafa-thaytorafa-thayto commented May 11, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Fixesclerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected #269. clerk env pull --file <absolute path> no longer silently writes under the project cwd; it writes exactly where the user asked.
  • Root cause: resolveTargetFile called path.join(cwd, flag), which doesn't treat an absolute second arg as a reset. --file /Users/u/clerk-dev.env from /Users/u/Developer/some-dir produced /Users/u/Developer/some-dir/Users/u/clerk-dev.env. Bun.write auto-creates parent dirs, so the wrong write succeeded and the success log (which printed options.file verbatim) was misleading. Swapped to path.resolve — absolute paths are honored, relative paths still resolve against cwd.

Test plan

  • Added pull.test.ts > "writes --file to an absolute path outside cwd" — file lands at the absolute path, not nested under cwd; success log shows the resolved path.
  • Added pull.test.ts > "writes --file with no package.json present (framework detection fails)" — reproduces the exact scenario from the issue (non-framework dir + absolute --file) and verifies keys land at the requested path.
  • Existing 26 env-pull tests still green (28/28 pass).
  • bun run format / bun run lint / bun run typecheck / bun run test all pass locally (97/97).
  • Reviewer to spot-check clerk env pull --file /tmp/foo.env from a fresh dir against the prebuilt binary once CI publishes the preview build.

`resolveTargetFile` used `path.join(cwd, flag)`, which doesn't reset on
an absolute argument. `--file /Users/u/clerk-dev.env` from a project
cwd silently landed at `<cwd>/Users/u/clerk-dev.env` while the success
message still claimed it was written at the user's path. Swap to
`path.resolve` so absolute paths are honored and relative paths still
resolve against cwd.
Fixes#269
@changeset-bot

changeset-botBot commented May 11, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b86

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 May 11, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Rate limit exceeded

@rafa-thayto has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 44 minutes and 29 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c863c98-5532-43b1-86ba-63f6b66cf56a

📥 Commits

Reviewing files that changed from the base of the PR and between 5a5b2ea and 7578b86.

📒 Files selected for processing (2)
  • packages/cli-core/src/commands/env/pull.test.ts
  • packages/cli-core/src/commands/env/pull.ts
📝 Walkthrough

Walkthrough

This PR fixes a critical bug in clerk env pull --file <path> where absolute file paths were being incorrectly nested under the current working directory instead of being written to their specified locations. The fix changes path resolution from path.join(cwd, flag) to path.resolve(cwd, flag), which correctly preserves absolute paths while still anchoring relative paths to the working directory. Display path formatting is simplified to use basename(). Test coverage is added for absolute path handling both with and without package.json present. Documentation is updated to clarify the expected behavior.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check nameStatusExplanationResolution
Docstring Coverage⚠️ WarningDocstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check nameStatusExplanation
Title check✅ PassedThe title accurately summarizes the main change: fixing --file absolute path resolution in clerk env pull command.
Linked Issues check✅ PassedThe PR fully addresses issue #269 by switching from path.join() to path.resolve() to honor absolute paths, adds comprehensive tests, and verifies all existing tests pass.
Out of Scope Changes check✅ PassedAll changes are focused on fixing the absolute file path resolution bug and documenting the fix; no unrelated modifications are present.
Description check✅ PassedThe pull request description clearly explains the bug fix, root cause, implementation details, and test coverage related to the changeset.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@rafa-thayto

Copy link
Copy Markdown
ContributorAuthor

!snapshot

Two cleanup passes on the env-pull test file:
- `pull.test.ts:397` checked `Bun.file(join(tempDir, absoluteTarget)).exists()`
to assert "nothing was written inside cwd". But `path.join` with an absolute
second arg concatenates rather than nests (the exact bug the source fix
addresses), so the assertion was vacuous. Replaced with a check that the
default fallback `.env.local` was not created inside cwd — a meaningful
invariant that --file fully overrides auto-detection.
- Renamed the second test to describe what it actually asserts (absolute
path with no package.json) instead of "framework detection fails", and
dropped the unnecessary `app`/`instance` flags so it differs from T1 only
in the missing package.json.
- Trimmed two paraphrase comments in the same test.
- Shortened the WHY comment in `resolveTargetFile` to one line.
@github-actions

Copy link
Copy Markdown
Contributor

Snapshot published

npm install -g clerk@1.2.1-snapshot.5a5b2ea
PackageVersion
clerk1.2.1-snapshot.5a5b2ea

Published from 5a5b2ea

@rafa-thayto
rafa-thayto merged commit 187384d into mainMay 11, 2026
10 checks passed
@rafa-thayto
rafa-thayto deleted the dull-shingle branch May 11, 2026 16:24
@github-actionsgithub-actionsBot mentioned this pull request May 11, 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.

clerk env pull --file <path> prints success but writes no file (exits 1) when framework cannot be detected

2 participants

@rafa-thayto@djgould