Skip to content

Rename changeset tag to changeset git-tag - #2128

Merged
bluwy merged 3 commits into
mainfrom
rename-tag-cmd
Jun 30, 2026
Merged

Rename changeset tag to changeset git-tag#2128
bluwy merged 3 commits into
mainfrom
rename-tag-cmd

Conversation

@Andarist

Copy link
Copy Markdown
Member

changeset publish accepts both --tag and --git-tag. I think changeset tag was incorrectly named when it got introduced as that didn't match the preexisting changeset publish vocab.

@Andarist
Andarist requested review from beeequeue and bluwy June 26, 2026 11:23
@changeset-bot

changeset-bot Bot commented Jun 26, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 0976d7b

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

This PR includes changesets to release 1 package
Name Type
@changesets/cli Major

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

@codecov

codecov Bot commented Jun 26, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 80.00000% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 87.28%. Comparing base (070f531) to head (0976d7b).
⚠️ Report is 3 commits behind head on main.

Files with missing lines Patch % Lines
packages/cli/src/cli.ts 75.00% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2128      +/-   ##
==========================================
+ Coverage   86.18%   87.28%   +1.09%     
==========================================
  Files          71       71              
  Lines        2585     2548      -37     
  Branches      703      681      -22     
==========================================
- Hits         2228     2224       -4     
+ Misses        330      300      -30     
+ Partials       27       24       -3     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

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

LGTM 🎉

Thanks for the cleanup!

@bluwy

bluwy commented Jun 26, 2026

Copy link
Copy Markdown
Member

I think it's fine keeping it as tag though. We don't need the commands to be related to npm, so tag being "tagged via git" is somewhat ok to me. So I think it's not worth breaking or deprecating for now, until we have some plans to create a different changeset tag command & behaviour.

@Andarist

Copy link
Copy Markdown
Member Author

I'm fine with keeping the name as-is - but I recall some users reporting in the past that changeset tag was misleading to them because it was different from what changeset publish calls a tag

@bluwy

bluwy commented Jun 30, 2026

Copy link
Copy Markdown
Member

I think after reviewing changesets/action#680, I could kinda see the benefit of this. But if we're to land this, the changeset tag command should still work but log a deprecation warning instead.

@trueberryless

Copy link
Copy Markdown
Contributor

I think after reviewing changesets/action#680, I could kinda see the benefit of this. But if we're to land this, the changeset tag command should still work but log a deprecation warning instead.

I mean to be fair, we also rename some action inputs in that major bump without deprecation, so why not do it like that here?

Not to say, I do not like a slow migration. I can see that in the action two inputs for one setting at the same time are confusing, so it makes sense there. But theoretically we could do the same error with a "got renamed" message here as well...

@Andarist

Copy link
Copy Markdown
Member Author

I don't mind making the old changeset tag work with a deprecation warning - given we don't really have any other plans for changeset tag.

I pushed out a commit to that effect

Comment thread packages/cli/src/cli.ts
cli
.command("tag", "Create git tags for the current version of all packages")
.command("git-tag", "Create git tags for the current version of all packages")
.alias("tag")

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

from what i can tell this alias doesn't appear in the --help and I couldn't think of any other place that could be somehow negatively affected by this

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.

Yeah I think that's ok

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

my initial reaction was that i didn't see the point in doing this, but in the end it's more specific which can only help.

@bluwy

bluwy commented Jun 30, 2026

Copy link
Copy Markdown
Member

I mean to be fair, we also rename some action inputs in that major bump without deprecation, so why not do it like that here?

Not to say, I do not like a slow migration. I can see that in the action two inputs for one setting at the same time are confusing, so it makes sense there. But theoretically we could do the same error with a "got renamed" message here as well...

For me the core commands here feel more important and general, where it can be used for many cases like setting up a custom bash script, child process, custom workflows etc that it's intricate. If it suddenly doesn't work, it'd have a larger impact compared to the breaking changes in the action.

But you're right, initially we're conservative with breaking changes, making the major mostly clean-up focused, but we've recently been making quite some breaking stuff already. But given compat support is only a few lines, I think we can swallow the cost for now.

@bluwy
bluwy added this pull request to the merge queue Jun 30, 2026
Merged via the queue into main with commit 7113c01 Jun 30, 2026
11 of 12 checks passed
@bluwy
bluwy deleted the rename-tag-cmd branch June 30, 2026 08:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants