feat(codemods): add an upgrade CLI backed by a migration catalogue - #2978

Merged

mfal merged 82 commits into

nextfrom

claude/flow-codemod-upgrade-cli-f87427

Aug 31, 2026

Commits on Aug 31, 2026

docs: plan the codemods upgrade CLI and migration catalogue

mfal
and
claude
committed
60fe889
docs: adopt PR #2942 into the plan and add the deprecation follow-up

mfal
and
claude
committed
0cd6023
docs: record the accepted red commit in task 3

mfal
and
claude
committed
4c094a8
docs: do not hardcode the package version in the plan

mfal
and
claude
committed
04d3e20
docs: stop the plan from hardcoding the package version

mfal
and
claude
committed
6ed2364
feat(codemods): adopt the transform suite and test harness from #2942

mfal
and
claude
committed
b4bf976
feat(codemods): publish the package with a CLI entry point

mfal
and
claude
committed
7fa7089
docs: record the ESM extension and tsc findings from task 1

mfal
and
claude
committed
8a0d95d
fix(codemods): set exitCode instead of calling process.exit

mfal
and
claude
committed
e26c98a
feat(codemods): add the migration catalogue and its generated module

mfal
and
claude
committed
f7bbb2b
chore: ignore the superpowers scratch directory

mfal
and
claude
committed
28f9655
fix(codemods): make the catalogue generator deterministic and its detect runnable

mfal
and
claude
committed
17b9964
feat(codemods): generate MIGRATION.md from the catalogue

mfal
and
claude
committed
75fb720
fix(codemods): correct the since version of the package-root import migration

mfal
and
claude
committed
b648460
docs: fix the since value and the tool filter in the plan

mfal
and
claude
committed
5518ddd
docs: restore the remoteScope invariant as a task 4 step

mfal
and
claude
committed
873162f
fix(codemods): make the catalogue's detect, apply and verify fields true

mfal
and
claude
committed
b03fee1
feat(codemods): rename transforms to catalogue ids and retire the URL path

mfal
and
claude
committed
3e22253
docs: reconcile task 14's AGENTS.md step with what task 4 already did

mfal
and
claude
committed
135103c
feat(codemods): select catalogue entries for a version range

mfal
and
claude
committed
b4b5d60
fix(codemods): make the gate's exhaustiveness check and its prerelease test real

mfal
and
claude
committed
b77178a
docs: make the gate snippet exhaustive and its prerelease test discriminating

mfal
and
claude
committed
25396ed
feat(codemods): resolve a revision to a published target version

mfal
and
claude
committed
74c6401
docs: record the task 6 findings in the plan

mfal
and
claude
committed
999d381
docs: correct the prerelease target-resolution expectation

mfal
and
claude
committed
723345c
fix(codemods): cover a prerelease current and name every registry failure

mfal
and
claude
committed
03bc37a
feat(codemods): find and rewrite Flow dependencies in a consumer manifest

mfal
and
claude
committed
aa06eb6
docs: handle the string private flag in the package-list generator

mfal
and
claude
committed
4502e5a
docs: pin the manifest cases that could hide a defect

mfal
and
claude
committed
2c46455
test(codemods): pin the manifest cases that could hide a defect

mfal
and
claude
committed
dfe0fd4
feat(codemods): detect the package manager and guard a dirty tree

mfal
and
claude
committed
8ad2873
docs: fix the install and dirty-tree modules in the plan

mfal
and
claude
committed
bb93e98
fix(codemods): stop the install and the dirty-tree guard failing silently

mfal
and
claude
committed
a4f975b
feat(codemods): run a codemod by its catalogue id

mfal
and
claude
committed
e6b381a
docs: drive jscodeshift programmatically and respect the consumer's registry

mfal
and
claude
committed
18ecfac
fix(codemods): drive jscodeshift programmatically instead of scraping its output

mfal
and
claude
committed
2c62b45
fix(codemods): satisfy the repo's lint rules in three modules

mfal
and
claude
committed
37278de
feat(codemods): add the list command

mfal
and
claude
committed
bf454e8
fix(codemods): pin the list command's tool asymmetry and lower its sentinel

mfal
and
claude
committed
47cba8e
docs: pin the list command's tool asymmetry in the plan

mfal
and
claude
committed
653624f
feat(codemods): add the single-codemod command

mfal
and
claude
committed
050eb06
fix(codemods): stop a transform that declines every file reading as success

mfal
and
claude
committed
aff5728
docs: report declined files in the upgrade loop too

mfal
and
claude
committed
2a4650e
feat(codemods): add the upgrade command

mfal
and
claude
committed
fe5cbc5
feat(codemods): wire the upgrade command into the CLI

mfal
and
claude
committed
9b6a8ba
fix(codemods): stop upgrade damaging a project and reporting success

mfal
and
claude
committed
77e35da
chore(codemods): wire the generators into nx

mfal
and
claude
committed
b893276
docs(codemods): document the catalogue and the upgrade CLI

mfal
and
claude
committed
881d83d
docs: format the plan document

mfal
and
claude
committed
0e1bb94
fix(codemods): resolve the target from what every Flow dependency published

mfal
and
claude
committed
11e6ca7
feat(codemods): make list output readable in a terminal

mfal
and
claude
committed
91296d4
docs: plan detect and verify as executable modules

mfal
and
claude
committed
f229deb
feat(codemods): add detect/verify commands and the checks module shape

mfal
and
claude
committed
0cf185c
refactor(codemods): drop detect/verify prose and list's title line

mfal
and
claude
committed
b19e0b4
revert(codemods): take the detect and verify commands back out

mfal
and
claude
committed
a58ac2b
refactor(codemods): cut detect and verify from the migration catalogue

mfal
and
claude
committed
75f35ec
docs: drop the execution plan

mfal
and
claude
committed
1dee701
refactor(codemods): drop to-remote-package from the migration catalogue

mfal
and
claude
committed
63057be
refactor(codemods): make list take a revision instead of --from/--to

mfal
and
claude
committed
127313c
fix(codemods): explain why a revision could not be resolved, not just that it couldn't

mfal
and
claude
committed
6be7018
fix(codemods): drop the lower bound for codemod catch-up, keep it for manual migrations

mfal
and
claude
committed
cb39956
fix(codemods): tidy list/upgrade output — zero-width range, legend, and duplicate header

mfal
and
claude
committed
82174e5
fix(codemods): shorten list header to three lines

mfal
and
claude
committed
bdc7bec
refactor(codemods): colocate each migration's entry, codemod and test

mfal
and
claude
committed
e428409
fix(codemods): move list's summary below the entries, make colour deterministic

mfal
and
claude
committed
b686a50
fix(codemods): drop the manual-entry lower bound, mark catch-up everywhere

mfal
and
claude
committed
43704c6
fix(codemods): wrap the catch-up legend like every other line

mfal
and
claude
committed
14858eb
docs: point every migration pointer at the catalogue and the CLI

mfal
and
claude
committed
450e2af
docs: tell the installation page how to stay current

mfal
and
claude
committed
081cb1f
fix(codemods): rewrite value positions, catalogue the password-tools subpath

mfal
and
claude
committed
b062557
Merge remote-tracking branch 'origin/next' into claude/flow-codemod-upgrade-cli-f87427
mfal
committed
4e427f4
Merge remote-tracking branch 'origin/next' into claude/flow-codemod-upgrade-cli-f87427
mfal
committed
46aafc4
fix(codemods): stop a guard test racing the remote-component generator

mfal
and
claude
committed
10da66b
docs: correct the ADR to the CLI that was actually built

mfal
and
claude
committed
bc8f445
docs: stop the docs implying upgrade has a lower bound

mfal
and
claude
committed
1e49cb4
docs: correct the docs-page layout and the cross-version CI split

mfal
and
claude
committed
dff6122
Merge remote-tracking branch 'origin/next' into claude/flow-codemod-upgrade-cli-f87427
mfal
committed
888d316
Merge remote-tracking branch 'origin/next' into claude/flow-codemod-upgrade-cli-f87427
mfal
committed
80b8c43
fix(codemods): stop imports-to-package-root corrupting current code

mfal
and
claude
committed
36cbd48
Merge remote-tracking branch 'origin/next' into claude/flow-codemod-upgrade-cli-f87427
mfal
committed
8f66c28
fix(codemods): make the interactive gate an input, not an environment read

mfal
and
claude
committed
9bde64f
Merge remote-tracking branch 'origin/next' into claude/flow-codemod-upgrade-cli-f87427
mfal
committed
fe103ab