merge

Source excerpt starting at line 1.

1# Clean Changesets2 3Remove changeset files that were already released on `main` and should not be included in the `next` branch's pre-release versioning.4 5**SCOPE: Do not spawn tasks/sub-agents.**6 7## Prerequisites8 9- The working directory is the repo root, checked out on the merge branch.10- Dependencies may NOT be installed yet — do not run any `pnpm` commands that require `node_modules`.11 12## Background13 14When `main` is merged into `next`, changeset files (`.changeset/*.md`) that were consumed by a release on `main` may still appear as new files on `next` if the `next` branch diverged before that release. These stale changesets cause pre-release versions on `next` to include version bumps that were already released as stable versions, leading to version conflicts like `@astrojs/sitemap@3.6.1-beta.3` being published after `@astrojs/sitemap@3.7.0`.15 16## Steps17 181. **Identify stale changesets.** Compare the changeset files on this branch against what exists on `origin/next`:19 20   ```bash21   # List changeset .md files that are new (not in next already)22   git diff --name-only --diff-filter=A origin/next -- .changeset/23   ```24 252. **Check each new changeset.** For each file found:26   - Read the file contents to see which packages it bumps27   - Check if those bumps have already been released on `main` by looking at the current versions in `package.json` files on `origin/main`28   - A changeset is stale if the version bump it describes has already been released29 303. **Also check `pre.json`.** Read `.changeset/pre.json` if it exists. This file tracks the pre-release state. Ensure it does not reference any changesets that should be removed.31 324. **Remove stale changesets.** Delete the identified files:33 34   ```bash35   git rm .changeset/<stale-file>.md36   ```37 385. **Verify.** Check that the remaining changeset `.md` files look valid (proper frontmatter with package names and bump types).39 406. Do NOT commit or run `pnpm install` — the orchestrator will handle that.41 42## Important Notes43 44- Do NOT remove changesets that are specific to `next` (ones that describe major version changes or new features being developed on `next`).45- Do NOT remove the `.changeset/config.json` file.46- Do NOT remove `.changeset/pre.json` — it's needed for pre-release mode.47- If unsure whether a changeset is stale, err on the side of keeping it. A human reviewer can remove it later.48 49## Output50 51Return the list of changeset files that were removed.52