[dreamwasp]

Overview

Last PR in the stack. It adds the gamut-scope-swap agent skill and the fixtures that run every migration together.

Note

This branch is a merge of the Video/Markdown, deep imports, ESLint, and Next.js PRs, because the skill and the combined fixtures need all of them. Its base is the scope-rename PR, so until those four merge, this diff includes their changes. Review only the last commit (feat(gamut-agent-tools): add the gamut-scope-swap skill), and rebase onto main once the others land.

Stack (split from #28, merge in order):

1. feat(gamut-codemods): add the codemods CLI and an empty scope-swap preset #38 Scaffold, based on main
2. feat(gamut-codemods): rename packages and replace gamut-kit in scope-swap #39 Package scope rename and gamut-kit removal, based on feat(gamut-codemods): add the codemods CLI and an empty scope-swap preset #38
3. feat(gamut-codemods): move Video imports and add Markdown video overrides #40 Video and Markdown, based on feat(gamut-codemods): rename packages and replace gamut-kit in scope-swap #39
4. feat(gamut)!: promote deep imports to the root, renaming Menu and SelectDropdown elements #41 Deep imports and Menu/SelectDropdown renames, based on feat(gamut-codemods): rename packages and replace gamut-kit in scope-swap #39
5. feat(gamut-codemods): rename the ESLint plugin prefix in scope-swap #42 ESLint plugin prefix, based on feat(gamut-codemods): rename packages and replace gamut-kit in scope-swap #39
6. feat(gamut-codemods): warn about esmExternals: false in next.config #43 Next.js esmExternals warning, based on feat(gamut-codemods): rename packages and replace gamut-kit in scope-swap #39
7. build(deps): make @skillsoft packages easier to install #44 Simpler dependencies (independent), based on main
8. feat(gamut-agent-tools): add the gamut-scope-swap skill #45 gamut-scope-swap skill (open last), based on feat(gamut-codemods): rename packages and replace gamut-kit in scope-swap #39, includes feat(gamut-codemods): move Video imports and add Markdown video overrides #40–feat(gamut-codemods): warn about esmExternals: false in next.config #43 👈 this PR

• gamut-scope-swap skill in @skillsoft/gamut-agent-tools. It works alongside the codemod: it reads the warnings, leftovers, and next steps, and helps with what the codemod can't rewrite. That covers deep imports, Video, the renamed Menu exports, tsconfig dom, jest mocks, ESLint plugin keys, Module Federation config, and preview builds. It doesn't run the codemod unless asked.
• BREAKING_CHANGES.md is the short list of every change in the move, with the manual ones marked.
• NEXT_EMOTION_INTEROP.md is the fallback for Next.js apps that can't drop esmExternals: false yet. The codemods README now links to it.
• READMEs: the gamut-agent-tools README and the codemods README point to the skill.
• Fixtures: restores the end-to-end and MDX fixtures that cover the rename, Video, deep imports, ESLint, and gamut-kit in one file.
• Merge fix: fixes the cli.test.ts merge between the sibling branches.

PR Checklist

• Related to designs: N/A
• Related to JIRA ticket: GMT-1790
• Changeset added
• I have run this code to verify it works
• This PR includes unit tests for the code change
• This PR includes testing instructions for the code change
• Package previews from this PR are passing end-to-end tests in all relevant consuming repositories

Testing Instructions

1. yarn nx test gamut-codemods. Expect 100 tests to pass, including the combined end-to-end and MDX fixtures.

2. Run the whole preset on a consumer repo (or a copy of one), then install the skill from the app repo:

   node <repo>/packages/gamut-codemods/dist/bin.js scope-swap .
   gamut plugin install claude   # or: gamut plugin install cursor

3. Ask the agent to work through the output. It should use the warnings and leftovers, refer to BREAKING_CHANGES.md for anything it can't rewrite, and not rerun the codemod unless you ask it to.

4. Read BREAKING_CHANGES.md against the PRs in the stack. Every breaking change should be listed.

PR Links and Envs

Repository	PR Link
Mono	N/A

🤖 Generated with Claude Code