From 4a331a440cec76b22dc11fcefec79bda41038027 Mon Sep 17 00:00:00 2001 From: Andrei Borza Date: Tue, 14 Jul 2026 23:20:24 +0200 Subject: [PATCH 1/5] chore(skills): Add bump-conventions skill Co-Authored-By: Opus 4.8 --- .agents/skills/bump-conventions/SKILL.md | 64 ++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 .agents/skills/bump-conventions/SKILL.md diff --git a/.agents/skills/bump-conventions/SKILL.md b/.agents/skills/bump-conventions/SKILL.md new file mode 100644 index 000000000000..b945503aac15 --- /dev/null +++ b/.agents/skills/bump-conventions/SKILL.md @@ -0,0 +1,64 @@ +--- +name: bump-conventions +description: Bump the @sentry/conventions dependency to a new version across every package in the monorepo. Use when upgrading, bumping, or aligning @sentry/conventions, or when a new @sentry/conventions release needs to be pulled into all workspaces. +argument-hint: '[version] # e.g. 0.16.0; defaults to latest on npm' +--- + +# Bump `@sentry/conventions` + +Bump `@sentry/conventions` across every `package.json` at once, keeping the two pin styles consistent, then refresh `yarn.lock`. + +## 1. Determine the target version + +If the user gave a version, use it. Otherwise get the latest: + +```bash +npm view @sentry/conventions version +``` + +## 2. Update every declared version + +Find every `package.json` that declares `@sentry/conventions` (use the Grep tool so `node_modules` and build output are skipped automatically) and bump each to the new version. There are two pin styles, and **each must keep its style**: + +- `packages/*` declare a caret range in `dependencies`, e.g. `"^0.15.1"` → `"^0.16.0"` +- `dev-packages/*` test suites declare an exact pin in `devDependencies`, e.g. `"0.15.1"` → `"0.16.0"` + +Edit only the version string; leave the caret alone. If a file declares a version that matches neither the current caret nor the exact pin, list it and confirm with the user before touching it. Preserve each file's trailing newline. + +## 3. Refresh the lockfile and build + +```bash +yarn install +yarn dedupe-deps:fix +yarn build:dev +``` + +`yarn install` collapses the combined `yarn.lock` entry (`"@sentry/conventions@", "@sentry/conventions@^":`) onto the new version. Confirm no stale `` resolution remains: + +```bash +grep -n '@sentry/conventions@' yarn.lock +``` + +## 4. Check for breaking API changes + +A `conventions` bump can rename or remove exported attribute constants. If `yarn build:dev` fails, inspect the type errors and update usages in `src/` **and** `test/`. Heaviest consumers: `packages/core`, `packages/opentelemetry`, `packages/aws-serverless`. + +Use LSP `findReferences` on the changed export to catch every call site. Do not paper over a rename with a cast. + +## 5. Final verification + +```bash +yarn circularDepCheck +yarn fix +yarn test +``` + +## Commit + +Use the `feat(deps):` prefix the repo uses for dependency bumps: + +``` +feat(deps): Bump `@sentry/conventions` to +``` + +Follow the repo's commit and PR conventions (target `develop`, draft PR, `## What` / `## Why`). Do **not** create the commit yourself unless the user invokes `/commit-push-pr`. From 09222c0f68bf448a2f86a78608cb6ff1642ebd52 Mon Sep 17 00:00:00 2001 From: Andrei Borza Date: Wed, 15 Jul 2026 09:28:53 +0200 Subject: [PATCH 2/5] Remove commit/PR conventions line referencing local-only skill --- .agents/skills/bump-conventions/SKILL.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/.agents/skills/bump-conventions/SKILL.md b/.agents/skills/bump-conventions/SKILL.md index b945503aac15..4c9ac663f4a5 100644 --- a/.agents/skills/bump-conventions/SKILL.md +++ b/.agents/skills/bump-conventions/SKILL.md @@ -60,5 +60,3 @@ Use the `feat(deps):` prefix the repo uses for dependency bumps: ``` feat(deps): Bump `@sentry/conventions` to ``` - -Follow the repo's commit and PR conventions (target `develop`, draft PR, `## What` / `## Why`). Do **not** create the commit yourself unless the user invokes `/commit-push-pr`. From 11ce45ab94a88c44c404b1a10e06c66a7b938db8 Mon Sep 17 00:00:00 2001 From: Andrei Borza Date: Wed, 15 Jul 2026 09:37:08 +0200 Subject: [PATCH 3/5] Re-run build:dev after breaking-change fixes before verification --- .agents/skills/bump-conventions/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.agents/skills/bump-conventions/SKILL.md b/.agents/skills/bump-conventions/SKILL.md index 4c9ac663f4a5..b06bfa44114b 100644 --- a/.agents/skills/bump-conventions/SKILL.md +++ b/.agents/skills/bump-conventions/SKILL.md @@ -45,6 +45,8 @@ A `conventions` bump can rename or remove exported attribute constants. If `yarn Use LSP `findReferences` on the changed export to catch every call site. Do not paper over a rename with a cast. +After fixing, re-run `yarn build:dev` and confirm it passes before verifying, so the next step runs against fresh build output. + ## 5. Final verification ```bash From 432fba17e1ebdc584945076e7725d6cb28140e04 Mon Sep 17 00:00:00 2001 From: Andrei <168741329+andreiborza@users.noreply.github.com> Date: Wed, 15 Jul 2026 09:53:25 +0200 Subject: [PATCH 4/5] Update .agents/skills/bump-conventions/SKILL.md Co-authored-by: Charly Gomez --- .agents/skills/bump-conventions/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.agents/skills/bump-conventions/SKILL.md b/.agents/skills/bump-conventions/SKILL.md index b06bfa44114b..0dccfc53e74c 100644 --- a/.agents/skills/bump-conventions/SKILL.md +++ b/.agents/skills/bump-conventions/SKILL.md @@ -57,7 +57,7 @@ yarn test ## Commit -Use the `feat(deps):` prefix the repo uses for dependency bumps: +Use the `chore(deps):` prefix the repo uses for dependency bumps: ``` feat(deps): Bump `@sentry/conventions` to From 3b57c7212bafc93bed365f7a61f33a6f65fc6c36 Mon Sep 17 00:00:00 2001 From: Andrei <168741329+andreiborza@users.noreply.github.com> Date: Wed, 15 Jul 2026 09:55:16 +0200 Subject: [PATCH 5/5] Update .agents/skills/bump-conventions/SKILL.md Co-authored-by: Charly Gomez --- .agents/skills/bump-conventions/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.agents/skills/bump-conventions/SKILL.md b/.agents/skills/bump-conventions/SKILL.md index 0dccfc53e74c..a793b52fa6b6 100644 --- a/.agents/skills/bump-conventions/SKILL.md +++ b/.agents/skills/bump-conventions/SKILL.md @@ -60,5 +60,5 @@ yarn test Use the `chore(deps):` prefix the repo uses for dependency bumps: ``` -feat(deps): Bump `@sentry/conventions` to +chore(deps): Bump `@sentry/conventions` to ```