You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+14Lines changed: 14 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,6 +38,16 @@ The plugin automatically activates during `composer update` and:
38
38
39
39
In non-interactive environments (CI/CD), the plugin displays information but proceeds automatically. If the TYPO3 API is temporarily unavailable, the update continues without interruption.
40
40
41
+
## Major version upgrades
42
+
43
+
Cross-major updates (e.g. 12.4 → 13.4) are fully supported. Since a major upgrade path contains hundreds of breaking changes, the report switches to a condensed format:
44
+
45
+
- A banner announces the upgrade with links to the official upgrade guide and the changelog of every crossed major
46
+
- Breaking changes appear as a per-release count (e.g. `13.0.0: ⚠️ 207 breaking changes`) instead of a full list — security updates keep their complete detail (CVEs, severities, bulletins)
47
+
- Updates within a major line keep the detailed format as before
48
+
- A major upgrade always asks for confirmation in interactive shells, even when release information could not be fetched
49
+
- Jumping more than one major at once (e.g. 12 → 14) prints an additional warning, since TYPO3 officially supports upgrading one major version at a time
50
+
41
51
## Example output
42
52
43
53

@@ -55,8 +65,12 @@ Both arguments are optional. With no arguments it uses your installed `typo3/cms
55
65
```bash
56
66
composer typo3:check-updates # installed version → latest release
composer typo3:check-updates 12.4.10 13.4.5 # across major versions
58
69
```
59
70
71
+
> [!NOTE]
72
+
> Defaults always stay within the installed major line — a cross-major check happens only when you pass the target explicitly. For an unknown cross-major target, the command offers the latest release of the requested major's line.
73
+
60
74
When a version is auto-detected or defaulted, the command asks for confirmation before checking. If you pass a target that doesn't exist, it offers the latest instead; an unknown current version (or missing versions in a non-interactive shell) is rejected with a hint.
0 commit comments