From 9ddcfbfa91d2df1b24c28f4a87024096ed7a51ec Mon Sep 17 00:00:00 2001
From: Jeremy Massel <1123407+jkmassel@users.noreply.github.com>
Date: Fri, 3 Apr 2026 15:28:08 -0600
Subject: [PATCH 1/8] docs: add CHANGELOG.md with breaking change tracking

Add a CHANGELOG.md following the release-toolkit format with historical
entries back to v0.3.0. Each version is categorized into Breaking Changes,
New Features, Bug Fixes, and Internal Changes.

The release script now automatically manages the Trunk section during
releases, and the developer workflow docs mention updating the changelog
when merging user-facing changes.
---
 CHANGELOG.md                     | 523 +++++++++++++++++++++++++++++++
 bin/release.sh                   |  47 +++
 docs/code/developer-workflows.md |   1 +
 docs/releases.md                 |  17 +-
 4 files changed, 586 insertions(+), 2 deletions(-)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 000000000..7f05c0d24
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,523 @@
+# GutenbergKit CHANGELOG
+
+---
+
+## Trunk
+
+### Breaking Changes
+
+_None_
+
+### New Features
+
+_None_
+
+### Bug Fixes
+
+_None_
+
+### Internal Changes
+
+_None_
+
+## 0.15.0
+
+### Breaking Changes
+
+-   Move editor loading into the library — callers no longer manage the editor load lifecycle. [#326]
+-   AJAX requests now use token authentication instead of cookie-based auth. [#181]
+
+### New Features
+
+-   Add cross-platform HTTP/1.1 parser and local proxy server for iOS and Android. [#367]
+
+### Bug Fixes
+
+-   Filter cross-origin "Script error." from Sentry reports. [#389]
+-   Improve iOS bridge stability. [#410]
+-   Normalize namespace trailing slash in RESTAPIRepository. [#421]
+-   Coerce post ID 0 to nil on both platforms and JS bridge. [#420]
+
+## 0.14.0
+
+### New Features
+
+-   Add local WordPress environment powered by wp-env. [#328]
+-   Improve iOS offline editor experience. [#366]
+-   Support editing posts of custom post types. [#299]
+
+### Bug Fixes
+
+-   Address Swift compiler warnings. [#306]
+-   Open external URLs in system browser on iOS. [#308]
+-   Exclude WordPress globals files from externals plugin. [#325]
+-   Upgrade @wordpress/format-library and fix PlainText CJS interop. [#323]
+-   Resolve Cover block inner UI inaccessible. [#332]
+-   Resolve iOS retain cycle in EditorViewController async flow. [#333]
+-   Resolve failures from @wordpress/edit-post bump. [#351]
+-   Skip editor settings fetch when theme styles are disabled. [#353]
+-   Add default typography settings for sites without editor settings. [#355]
+-   Include block library editor styles for correct placeholder UI. [#363]
+-   Gracefully handle missing translation files. [#364]
+-   Improve offline indicator accuracy with HTTP probe. [#387]
+-   Replace deprecated EditorSnackbars with SnackbarNotices. [#386]
+
+### Internal Changes
+
+-   Resolve patch-package version mismatch for @wordpress/format-library. [#356]
+-   Resolve iOS E2E test failures in block inserter. [#338]
+-   Mock oEmbed proxy in embed E2E test to prevent CI flakes. [#354]
+
+## 0.13.2
+
+### Bug Fixes
+
+-   Register MediaFileSchemeHandler for native iOS media insertion. [#309]
+
+## 0.13.1
+
+### Bug Fixes
+
+-   Skip post preloading for non-positive post IDs. [#293]
+-   Editor preloading survives blocked asset downloads. [#305]
+-   Ensure EditorAssetBundleProvider always replies to JavaScript. [#294]
+-   Fetch uncached assets from remote server. [#301]
+
+### Internal Changes
+
+-   Reinstate resolved demo app Swift packages. [#300]
+-   Fix test failures and reduce noise. [#303]
+-   Add PR guidelines to CLAUDE.md. [#304]
+
+## 0.13.0
+
+### New Features
+
+-   Recover content on WebView refresh via pull model. [#283]
+-   Add Android preload list. [#260]
+
+### Internal Changes
+
+-   Mock @wordpress modules throwing import errors. [#290]
+
+## 0.12.1
+
+### New Features
+
+-   Add custom user agent to GutenbergKit WebViews. [#255]
+
+### Bug Fixes
+
+-   Improve preloading robustness. [#288]
+
+### Internal Changes
+
+-   Make targets reuse JavaScript builds. [#265]
+
+## 0.12.0
+
+### Breaking Changes
+
+-   Update to Swift 6 — requires Swift 6 compiler toolchain. [#252]
+-   Disable cookies in EditorService. [#246]
+-   Remove unused `setup` method from public API. [#244]
+
+### New Features
+
+-   Add support for Editor Settings. [#232]
+-   Faster and more robust editor asset management. [#233]
+-   Add `editorSettingsEndpoint` to EditorConfiguration. [#245]
+-   Add iOS preload list. [#250]
+-   Add iOS preload tests. [#253]
+
+### Bug Fixes
+
+-   Fix compilation on macOS. [#248]
+-   Android demo app fills viewport. [#275]
+-   Toggle the code editor in the iOS demo app. [#274]
+
+### Internal Changes
+
+-   Upgrade dependencies. [#247]
+-   Log plugin load and editor initialization failures. [#249]
+-   Enable Dependabot for npm dependencies. [#251]
+-   Add Claude code review. [#254]
+-   Don't send cookies with requests. [#261]
+-   Expand and organize documentation. [#273]
+
+## 0.11.1
+
+### Bug Fixes
+
+-   Await configuration before initializing network logging. [#243]
+
+## 0.11.0
+
+### New Features
+
+-   Add native navigation bar overlay so modals better fit in. [#228]
+-   Expand error reporting. [#234]
+-   Log network activity. [#238]
+
+### Bug Fixes
+
+-   Incorrect media attachment position. [#227]
+-   Inline inserter opens native inserter. [#230]
+
+### Internal Changes
+
+-   Improve demo app consistency. [#226]
+-   Integrate the React Developer Tools. [#231]
+-   Update project configuration, scripts, and documentation. [#229]
+-   Improve Makefile. [#237]
+-   Improve code quality. [#239]
+-   Capture bridge message decoding failure details. [#240]
+-   Organize editor setup. [#242]
+
+## 0.10.2
+
+### New Features
+
+-   Discover Android demo app configuration. [#225]
+
+### Bug Fixes
+
+-   Mitigate Android `ERR_UPLOAD_FILE_CHANGE` errors. [#224]
+
+### Internal Changes
+
+-   Remove remote editor variant. [#210]
+
+## 0.10.1
+
+### Bug Fixes
+
+-   Prevent crash from duplicate category pattern keys. [#223]
+
+## 0.10.0
+
+### Breaking Changes
+
+-   Increase deployment target to iOS 17. [#189]
+-   Remove unused `EditorNetworking`. [#208]
+
+### New Features
+
+-   Add EditorViewModel. [#192]
+-   Auto-focus when creating a new post. [#191]
+-   Add block inserter flag and initial infrastructure. [#193]
+-   Add basic block inserter features: grid, search, icons, ordering. [#196]
+-   Native inserter: implement block insertion. [#199]
+-   Add infrastructure for injecting media pickers. [#201]
+-   Native inserter: add initial Photos integration. [#203]
+-   Native inserter: add inline compact PhotosPicker. [#212]
+-   Native inserter: show as popover on iPad. [#215]
+-   Native inserter: patterns. [#207]
+-   Native inserter: apply theme styles for pattern previews. [#218]
+-   Native inserter: private pattern categories and localizable titles. [#219]
+-   Native inserter: poor man internationalization. [#220]
+-   Native inserter: add support for inserting existing site media. [#221]
+-   Enable image resizing on mobile devices. [#213]
+-   Block toolbar indicates scrollable area. [#214]
+-   Bundled editor supports plugins. [#209]
+-   Improve editor load resiliency. [#222]
+-   Demo app navigates history state. [#187]
+-   Demo editor toggles code editor mode. [#188]
+-   Modernize Android demo app. [#194]
+-   iOS demo app discovers remote editors. [#197]
+
+### Bug Fixes
+
+-   Defer remote editor references to @wordpress modules. [#198]
+-   Native inserter: fix SVG rendering. [#205]
+-   Display drag-and-drop indicator. [#217]
+
+### Internal Changes
+
+-   Remove unused code. [#190]
+-   Remove unused AnyDecodable. [#200]
+-   Refactor Sample App and Logging. [#202]
+-   Improve local development server support. [#195]
+-   Prevent log noise in test results. [#211]
+
+## 0.9.0
+
+### New Features
+
+-   Theme styles supersede default styles. [#183]
+-   Update iOS demo app navigation. [#184]
+-   Update Android demo app navigation. [#185]
+-   Send modal dialog state to host app. [#186]
+
+## 0.8.1
+
+### Bug Fixes
+
+-   Prevent multiple Android WebView starts. [#175]
+-   Block customization without editor settings. [#180]
+-   Force visual editor mode to ensure consistency with native host UI. [#182]
+
+### Internal Changes
+
+-   Move remote assets code into individual files. [#176]
+-   Add Configuration Builder and tests. [#146]
+-   Simplify iOS Settings. [#179]
+
+## 0.8.0
+
+### Breaking Changes
+
+-   Remove unnecessary WebView global configuration. [#172]
+
+### New Features
+
+-   Expose autocomplete triggers and text insertion utility. [#165]
+-   Forward original failed HTTP response to web view. [#167]
+
+### Bug Fixes
+
+-   API requests utilize single auth mechanism. [#166]
+-   Configure fetch requests occurring during editor initialization. [#168]
+
+### Internal Changes
+
+-   Improve release script. [#163]
+-   Improve debugging. [#164]
+
+## 0.7.0
+
+### New Features
+
+-   Bridge AJAX requests to the REST API. [#161]
+
+### Bug Fixes
+
+-   Prevent iOS crash in WebView navigations. [#159]
+
+### Internal Changes
+
+-   Add Claude instructions. [#160]
+
+## 0.6.0
+
+### Breaking Changes
+
+-   Remove iOS cookie configuration. [#157]
+
+### Bug Fixes
+
+-   Remove redundant trailing slash from API namespace configuration. [#158]
+
+## 0.5.0
+
+### New Features
+
+-   Add cookie support. [#144]
+-   Add multi-site support to Android demo app. [#155]
+-   Android asset caching implementation. [#153]
+
+### Bug Fixes
+
+-   Prevent reused Android WebView crash. [#152]
+-   Fix WebView memory leak in GutenbergView. [#156]
+
+### Internal Changes
+
+-   Change editor assets to the cache directory. [#154]
+
+## 0.4.1
+
+_Patch release — no user-facing changes._
+
+## 0.4.0
+
+### New Features
+
+-   Support caching remote assets. [#148]
+
+### Internal Changes
+
+-   Add instructions for remote editor. [#149]
+-   Release process script and documentation. [#151]
+
+## 0.3.0
+
+### New Features
+
+-   Internationalization. [#120]
+-   Mark content outside of popovers inert. [#145]
+-   Sync featured images to host app. [#147]
+-   Enable image resizing on mobile devices. [#213]
+
+### Bug Fixes
+
+-   Prevent block inserter horizontal overflow. [#127]
+-   Android presents file picker for File block upload. [#128]
+-   Mitigate Android text composition oddities. [#134]
+-   Scrolling along edges breaks text editing. [#135]
+-   Audio block iOS file picker compatibility. [#137]
+-   Embed renders. [#140]
+-   Prevent inline image crash. [#142]
+
+### Internal Changes
+
+-   Avoid unnecessary editor assets requests. [#126]
+-   Set up Vitest. [#131]
+-   Update @wordpress/block-editor patch. [#132]
+-   Assert useMediaUpload hook. [#141]
+-   Revert to AGP 8.7.3. [#143]
+
+[#120]: https://github.com/wordpress-mobile/GutenbergKit/pull/120
+[#126]: https://github.com/wordpress-mobile/GutenbergKit/pull/126
+[#127]: https://github.com/wordpress-mobile/GutenbergKit/pull/127
+[#128]: https://github.com/wordpress-mobile/GutenbergKit/pull/128
+[#131]: https://github.com/wordpress-mobile/GutenbergKit/pull/131
+[#132]: https://github.com/wordpress-mobile/GutenbergKit/pull/132
+[#134]: https://github.com/wordpress-mobile/GutenbergKit/pull/134
+[#135]: https://github.com/wordpress-mobile/GutenbergKit/pull/135
+[#136]: https://github.com/wordpress-mobile/GutenbergKit/pull/136
+[#137]: https://github.com/wordpress-mobile/GutenbergKit/pull/137
+[#140]: https://github.com/wordpress-mobile/GutenbergKit/pull/140
+[#141]: https://github.com/wordpress-mobile/GutenbergKit/pull/141
+[#142]: https://github.com/wordpress-mobile/GutenbergKit/pull/142
+[#143]: https://github.com/wordpress-mobile/GutenbergKit/pull/143
+[#144]: https://github.com/wordpress-mobile/GutenbergKit/pull/144
+[#145]: https://github.com/wordpress-mobile/GutenbergKit/pull/145
+[#146]: https://github.com/wordpress-mobile/GutenbergKit/pull/146
+[#147]: https://github.com/wordpress-mobile/GutenbergKit/pull/147
+[#148]: https://github.com/wordpress-mobile/GutenbergKit/pull/148
+[#149]: https://github.com/wordpress-mobile/GutenbergKit/pull/149
+[#151]: https://github.com/wordpress-mobile/GutenbergKit/pull/151
+[#152]: https://github.com/wordpress-mobile/GutenbergKit/pull/152
+[#153]: https://github.com/wordpress-mobile/GutenbergKit/pull/153
+[#154]: https://github.com/wordpress-mobile/GutenbergKit/pull/154
+[#155]: https://github.com/wordpress-mobile/GutenbergKit/pull/155
+[#156]: https://github.com/wordpress-mobile/GutenbergKit/pull/156
+[#157]: https://github.com/wordpress-mobile/GutenbergKit/pull/157
+[#158]: https://github.com/wordpress-mobile/GutenbergKit/pull/158
+[#159]: https://github.com/wordpress-mobile/GutenbergKit/pull/159
+[#160]: https://github.com/wordpress-mobile/GutenbergKit/pull/160
+[#161]: https://github.com/wordpress-mobile/GutenbergKit/pull/161
+[#163]: https://github.com/wordpress-mobile/GutenbergKit/pull/163
+[#164]: https://github.com/wordpress-mobile/GutenbergKit/pull/164
+[#165]: https://github.com/wordpress-mobile/GutenbergKit/pull/165
+[#166]: https://github.com/wordpress-mobile/GutenbergKit/pull/166
+[#167]: https://github.com/wordpress-mobile/GutenbergKit/pull/167
+[#168]: https://github.com/wordpress-mobile/GutenbergKit/pull/168
+[#172]: https://github.com/wordpress-mobile/GutenbergKit/pull/172
+[#175]: https://github.com/wordpress-mobile/GutenbergKit/pull/175
+[#176]: https://github.com/wordpress-mobile/GutenbergKit/pull/176
+[#179]: https://github.com/wordpress-mobile/GutenbergKit/pull/179
+[#180]: https://github.com/wordpress-mobile/GutenbergKit/pull/180
+[#181]: https://github.com/wordpress-mobile/GutenbergKit/pull/181
+[#182]: https://github.com/wordpress-mobile/GutenbergKit/pull/182
+[#183]: https://github.com/wordpress-mobile/GutenbergKit/pull/183
+[#184]: https://github.com/wordpress-mobile/GutenbergKit/pull/184
+[#185]: https://github.com/wordpress-mobile/GutenbergKit/pull/185
+[#186]: https://github.com/wordpress-mobile/GutenbergKit/pull/186
+[#187]: https://github.com/wordpress-mobile/GutenbergKit/pull/187
+[#188]: https://github.com/wordpress-mobile/GutenbergKit/pull/188
+[#189]: https://github.com/wordpress-mobile/GutenbergKit/pull/189
+[#190]: https://github.com/wordpress-mobile/GutenbergKit/pull/190
+[#191]: https://github.com/wordpress-mobile/GutenbergKit/pull/191
+[#192]: https://github.com/wordpress-mobile/GutenbergKit/pull/192
+[#193]: https://github.com/wordpress-mobile/GutenbergKit/pull/193
+[#194]: https://github.com/wordpress-mobile/GutenbergKit/pull/194
+[#195]: https://github.com/wordpress-mobile/GutenbergKit/pull/195
+[#196]: https://github.com/wordpress-mobile/GutenbergKit/pull/196
+[#197]: https://github.com/wordpress-mobile/GutenbergKit/pull/197
+[#198]: https://github.com/wordpress-mobile/GutenbergKit/pull/198
+[#199]: https://github.com/wordpress-mobile/GutenbergKit/pull/199
+[#200]: https://github.com/wordpress-mobile/GutenbergKit/pull/200
+[#201]: https://github.com/wordpress-mobile/GutenbergKit/pull/201
+[#202]: https://github.com/wordpress-mobile/GutenbergKit/pull/202
+[#203]: https://github.com/wordpress-mobile/GutenbergKit/pull/203
+[#205]: https://github.com/wordpress-mobile/GutenbergKit/pull/205
+[#207]: https://github.com/wordpress-mobile/GutenbergKit/pull/207
+[#208]: https://github.com/wordpress-mobile/GutenbergKit/pull/208
+[#209]: https://github.com/wordpress-mobile/GutenbergKit/pull/209
+[#210]: https://github.com/wordpress-mobile/GutenbergKit/pull/210
+[#211]: https://github.com/wordpress-mobile/GutenbergKit/pull/211
+[#212]: https://github.com/wordpress-mobile/GutenbergKit/pull/212
+[#213]: https://github.com/wordpress-mobile/GutenbergKit/pull/213
+[#214]: https://github.com/wordpress-mobile/GutenbergKit/pull/214
+[#215]: https://github.com/wordpress-mobile/GutenbergKit/pull/215
+[#217]: https://github.com/wordpress-mobile/GutenbergKit/pull/217
+[#218]: https://github.com/wordpress-mobile/GutenbergKit/pull/218
+[#219]: https://github.com/wordpress-mobile/GutenbergKit/pull/219
+[#220]: https://github.com/wordpress-mobile/GutenbergKit/pull/220
+[#221]: https://github.com/wordpress-mobile/GutenbergKit/pull/221
+[#222]: https://github.com/wordpress-mobile/GutenbergKit/pull/222
+[#223]: https://github.com/wordpress-mobile/GutenbergKit/pull/223
+[#224]: https://github.com/wordpress-mobile/GutenbergKit/pull/224
+[#225]: https://github.com/wordpress-mobile/GutenbergKit/pull/225
+[#226]: https://github.com/wordpress-mobile/GutenbergKit/pull/226
+[#227]: https://github.com/wordpress-mobile/GutenbergKit/pull/227
+[#228]: https://github.com/wordpress-mobile/GutenbergKit/pull/228
+[#229]: https://github.com/wordpress-mobile/GutenbergKit/pull/229
+[#230]: https://github.com/wordpress-mobile/GutenbergKit/pull/230
+[#231]: https://github.com/wordpress-mobile/GutenbergKit/pull/231
+[#232]: https://github.com/wordpress-mobile/GutenbergKit/pull/232
+[#233]: https://github.com/wordpress-mobile/GutenbergKit/pull/233
+[#234]: https://github.com/wordpress-mobile/GutenbergKit/pull/234
+[#237]: https://github.com/wordpress-mobile/GutenbergKit/pull/237
+[#238]: https://github.com/wordpress-mobile/GutenbergKit/pull/238
+[#239]: https://github.com/wordpress-mobile/GutenbergKit/pull/239
+[#240]: https://github.com/wordpress-mobile/GutenbergKit/pull/240
+[#242]: https://github.com/wordpress-mobile/GutenbergKit/pull/242
+[#243]: https://github.com/wordpress-mobile/GutenbergKit/pull/243
+[#244]: https://github.com/wordpress-mobile/GutenbergKit/pull/244
+[#245]: https://github.com/wordpress-mobile/GutenbergKit/pull/245
+[#246]: https://github.com/wordpress-mobile/GutenbergKit/pull/246
+[#247]: https://github.com/wordpress-mobile/GutenbergKit/pull/247
+[#248]: https://github.com/wordpress-mobile/GutenbergKit/pull/248
+[#249]: https://github.com/wordpress-mobile/GutenbergKit/pull/249
+[#250]: https://github.com/wordpress-mobile/GutenbergKit/pull/250
+[#251]: https://github.com/wordpress-mobile/GutenbergKit/pull/251
+[#252]: https://github.com/wordpress-mobile/GutenbergKit/pull/252
+[#253]: https://github.com/wordpress-mobile/GutenbergKit/pull/253
+[#254]: https://github.com/wordpress-mobile/GutenbergKit/pull/254
+[#255]: https://github.com/wordpress-mobile/GutenbergKit/pull/255
+[#260]: https://github.com/wordpress-mobile/GutenbergKit/pull/260
+[#261]: https://github.com/wordpress-mobile/GutenbergKit/pull/261
+[#265]: https://github.com/wordpress-mobile/GutenbergKit/pull/265
+[#273]: https://github.com/wordpress-mobile/GutenbergKit/pull/273
+[#274]: https://github.com/wordpress-mobile/GutenbergKit/pull/274
+[#275]: https://github.com/wordpress-mobile/GutenbergKit/pull/275
+[#276]: https://github.com/wordpress-mobile/GutenbergKit/pull/276
+[#283]: https://github.com/wordpress-mobile/GutenbergKit/pull/283
+[#288]: https://github.com/wordpress-mobile/GutenbergKit/pull/288
+[#290]: https://github.com/wordpress-mobile/GutenbergKit/pull/290
+[#293]: https://github.com/wordpress-mobile/GutenbergKit/pull/293
+[#294]: https://github.com/wordpress-mobile/GutenbergKit/pull/294
+[#299]: https://github.com/wordpress-mobile/GutenbergKit/pull/299
+[#300]: https://github.com/wordpress-mobile/GutenbergKit/pull/300
+[#301]: https://github.com/wordpress-mobile/GutenbergKit/pull/301
+[#303]: https://github.com/wordpress-mobile/GutenbergKit/pull/303
+[#304]: https://github.com/wordpress-mobile/GutenbergKit/pull/304
+[#305]: https://github.com/wordpress-mobile/GutenbergKit/pull/305
+[#306]: https://github.com/wordpress-mobile/GutenbergKit/pull/306
+[#308]: https://github.com/wordpress-mobile/GutenbergKit/pull/308
+[#309]: https://github.com/wordpress-mobile/GutenbergKit/pull/309
+[#323]: https://github.com/wordpress-mobile/GutenbergKit/pull/323
+[#325]: https://github.com/wordpress-mobile/GutenbergKit/pull/325
+[#326]: https://github.com/wordpress-mobile/GutenbergKit/pull/326
+[#328]: https://github.com/wordpress-mobile/GutenbergKit/pull/328
+[#332]: https://github.com/wordpress-mobile/GutenbergKit/pull/332
+[#333]: https://github.com/wordpress-mobile/GutenbergKit/pull/333
+[#338]: https://github.com/wordpress-mobile/GutenbergKit/pull/338
+[#351]: https://github.com/wordpress-mobile/GutenbergKit/pull/351
+[#353]: https://github.com/wordpress-mobile/GutenbergKit/pull/353
+[#354]: https://github.com/wordpress-mobile/GutenbergKit/pull/354
+[#355]: https://github.com/wordpress-mobile/GutenbergKit/pull/355
+[#356]: https://github.com/wordpress-mobile/GutenbergKit/pull/356
+[#363]: https://github.com/wordpress-mobile/GutenbergKit/pull/363
+[#364]: https://github.com/wordpress-mobile/GutenbergKit/pull/364
+[#366]: https://github.com/wordpress-mobile/GutenbergKit/pull/366
+[#367]: https://github.com/wordpress-mobile/GutenbergKit/pull/367
+[#386]: https://github.com/wordpress-mobile/GutenbergKit/pull/386
+[#387]: https://github.com/wordpress-mobile/GutenbergKit/pull/387
+[#389]: https://github.com/wordpress-mobile/GutenbergKit/pull/389
+[#410]: https://github.com/wordpress-mobile/GutenbergKit/pull/410
+[#420]: https://github.com/wordpress-mobile/GutenbergKit/pull/420
+[#421]: https://github.com/wordpress-mobile/GutenbergKit/pull/421
diff --git a/bin/release.sh b/bin/release.sh
index c00b60b50..54874e33e 100755
--- a/bin/release.sh
+++ b/bin/release.sh
@@ -247,6 +247,50 @@ build_project() {
     print_success "Build completed successfully"
 }
 
+# Function to update CHANGELOG.md for a release
+update_changelog() {
+    local version=$1
+
+    print_status "Updating CHANGELOG.md..."
+
+    if [ "$DRY_RUN" = "true" ]; then
+        return
+    fi
+
+    local changelog="CHANGELOG.md"
+
+    if [ ! -f "$changelog" ]; then
+        print_warning "CHANGELOG.md not found, skipping changelog update"
+        return
+    fi
+
+    # Replace "## Trunk" with the new version heading, then prepend a fresh Trunk section
+    sed -i '' "s/^## Trunk$/## $version/" "$changelog"
+
+    # Insert the new Trunk section after the horizontal rule
+    sed -i '' "/^---$/a\\
+\\
+## Trunk\\
+\\
+### Breaking Changes\\
+\\
+_None_\\
+\\
+### New Features\\
+\\
+_None_\\
+\\
+### Bug Fixes\\
+\\
+_None_\\
+\\
+### Internal Changes\\
+\\
+_None_" "$changelog"
+
+    print_success "CHANGELOG.md updated for version $version"
+}
+
 # Function to commit changes
 commit_changes() {
     local version=$1
@@ -375,6 +419,9 @@ main() {
         new_version=$(get_current_version)
     fi
 
+    update_changelog "$new_version"
+    echo
+
     build_project
     echo
 
diff --git a/docs/code/developer-workflows.md b/docs/code/developer-workflows.md
index 305158ca7..b34560cf0 100644
--- a/docs/code/developer-workflows.md
+++ b/docs/code/developer-workflows.md
@@ -38,6 +38,7 @@ When creating a pull request:
 1. **Use the PR template**: The template in `.github/PULL_REQUEST_TEMPLATE.md` provides the required structure.
 2. **Assign a label**: Use `gh label list` to see available labels and select the most relevant one.
 3. **Follow Conventional Commits**: The PR title should use the same format as commit messages above.
+4. **Update the changelog**: If your PR contains user-facing changes, add an entry to the appropriate section under `## Trunk` in `CHANGELOG.md`. Breaking changes are especially important to capture.
 
 ### Automatic Labeling
 
diff --git a/docs/releases.md b/docs/releases.md
index 4b0118b27..b19197778 100644
--- a/docs/releases.md
+++ b/docs/releases.md
@@ -30,15 +30,28 @@ The script:
 1. Checks that your working directory is clean
 1. Ensures required dependencies are installed
 1. Increments the version number[^1]
+1. Updates `CHANGELOG.md` — moves the Trunk section to the new version and creates a fresh Trunk section
 1. Builds the project[^2]
 1. Commits changes
 1. Creates a Git tag
 1. Pushes to `origin/trunk` with tags
-1. Creates a GitHub release
-1. Creates a new release on GitHub: `gh release create vX.X.X --generate-notes --title "X.X.X"`
+1. Creates a GitHub release: `gh release create vX.X.X --generate-notes --title "X.X.X"`
 
 After the release is created, it is ready for integration into the WordPress app.
 
+## Changelog
+
+The project maintains a `CHANGELOG.md` file at the repository root. It uses a **Trunk** section at the top where unreleased changes are staged under four categories:
+
+-   **Breaking Changes** — API removals, behavior changes, platform requirement increases
+-   **New Features** — new capabilities
+-   **Bug Fixes** — bug fixes
+-   **Internal Changes** — refactors, tooling, tests, docs
+
+When you merge a PR that contains user-facing changes, add an entry to the appropriate section in Trunk. Breaking changes are especially important to capture — they help consumers of the library plan upgrades.
+
+During a release, the script automatically renames the Trunk section to the new version number and creates a fresh empty Trunk section.
+
 ## Release Notes
 
 GitHub automatically generates release notes when a release is created. Notes are organized into the following categories based on PR labels:

From 7df5eb7b6fd6edc568f74a6328152fbb379c6837 Mon Sep 17 00:00:00 2001
From: Jeremy Massel <1123407+jkmassel@users.noreply.github.com>
Date: Mon, 13 Apr 2026 14:49:44 -0600
Subject: [PATCH 2/8] docs: scope CHANGELOG.md to breaking changes only
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Address review feedback — the comprehensive per-PR lists are redundant
with the auto-generated GitHub Release notes from #392. The CHANGELOG
now focuses exclusively on breaking changes, which is the one thing
GitHub Releases can't surface ahead of time via the Trunk staging area.
---
 CHANGELOG.md                     | 472 +------------------------------
 bin/release.sh                   |  12 -
 docs/code/developer-workflows.md |   2 +-
 docs/releases.md                 |   9 +-
 4 files changed, 5 insertions(+), 490 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7f05c0d24..e78e77473 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,7 @@
 # GutenbergKit CHANGELOG
 
+This file tracks **breaking changes** to help consumers plan upgrades. For the full list of changes in each release, see [GitHub Releases](https://github.com/wordpress-mobile/GutenbergKit/releases).
+
 ---
 
 ## Trunk
@@ -8,18 +10,6 @@
 
 _None_
 
-### New Features
-
-_None_
-
-### Bug Fixes
-
-_None_
-
-### Internal Changes
-
-_None_
-
 ## 0.15.0
 
 ### Breaking Changes
@@ -27,93 +17,6 @@ _None_
 -   Move editor loading into the library — callers no longer manage the editor load lifecycle. [#326]
 -   AJAX requests now use token authentication instead of cookie-based auth. [#181]
 
-### New Features
-
--   Add cross-platform HTTP/1.1 parser and local proxy server for iOS and Android. [#367]
-
-### Bug Fixes
-
--   Filter cross-origin "Script error." from Sentry reports. [#389]
--   Improve iOS bridge stability. [#410]
--   Normalize namespace trailing slash in RESTAPIRepository. [#421]
--   Coerce post ID 0 to nil on both platforms and JS bridge. [#420]
-
-## 0.14.0
-
-### New Features
-
--   Add local WordPress environment powered by wp-env. [#328]
--   Improve iOS offline editor experience. [#366]
--   Support editing posts of custom post types. [#299]
-
-### Bug Fixes
-
--   Address Swift compiler warnings. [#306]
--   Open external URLs in system browser on iOS. [#308]
--   Exclude WordPress globals files from externals plugin. [#325]
--   Upgrade @wordpress/format-library and fix PlainText CJS interop. [#323]
--   Resolve Cover block inner UI inaccessible. [#332]
--   Resolve iOS retain cycle in EditorViewController async flow. [#333]
--   Resolve failures from @wordpress/edit-post bump. [#351]
--   Skip editor settings fetch when theme styles are disabled. [#353]
--   Add default typography settings for sites without editor settings. [#355]
--   Include block library editor styles for correct placeholder UI. [#363]
--   Gracefully handle missing translation files. [#364]
--   Improve offline indicator accuracy with HTTP probe. [#387]
--   Replace deprecated EditorSnackbars with SnackbarNotices. [#386]
-
-### Internal Changes
-
--   Resolve patch-package version mismatch for @wordpress/format-library. [#356]
--   Resolve iOS E2E test failures in block inserter. [#338]
--   Mock oEmbed proxy in embed E2E test to prevent CI flakes. [#354]
-
-## 0.13.2
-
-### Bug Fixes
-
--   Register MediaFileSchemeHandler for native iOS media insertion. [#309]
-
-## 0.13.1
-
-### Bug Fixes
-
--   Skip post preloading for non-positive post IDs. [#293]
--   Editor preloading survives blocked asset downloads. [#305]
--   Ensure EditorAssetBundleProvider always replies to JavaScript. [#294]
--   Fetch uncached assets from remote server. [#301]
-
-### Internal Changes
-
--   Reinstate resolved demo app Swift packages. [#300]
--   Fix test failures and reduce noise. [#303]
--   Add PR guidelines to CLAUDE.md. [#304]
-
-## 0.13.0
-
-### New Features
-
--   Recover content on WebView refresh via pull model. [#283]
--   Add Android preload list. [#260]
-
-### Internal Changes
-
--   Mock @wordpress modules throwing import errors. [#290]
-
-## 0.12.1
-
-### New Features
-
--   Add custom user agent to GutenbergKit WebViews. [#255]
-
-### Bug Fixes
-
--   Improve preloading robustness. [#288]
-
-### Internal Changes
-
--   Make targets reuse JavaScript builds. [#265]
-
 ## 0.12.0
 
 ### Breaking Changes
@@ -122,78 +25,6 @@ _None_
 -   Disable cookies in EditorService. [#246]
 -   Remove unused `setup` method from public API. [#244]
 
-### New Features
-
--   Add support for Editor Settings. [#232]
--   Faster and more robust editor asset management. [#233]
--   Add `editorSettingsEndpoint` to EditorConfiguration. [#245]
--   Add iOS preload list. [#250]
--   Add iOS preload tests. [#253]
-
-### Bug Fixes
-
--   Fix compilation on macOS. [#248]
--   Android demo app fills viewport. [#275]
--   Toggle the code editor in the iOS demo app. [#274]
-
-### Internal Changes
-
--   Upgrade dependencies. [#247]
--   Log plugin load and editor initialization failures. [#249]
--   Enable Dependabot for npm dependencies. [#251]
--   Add Claude code review. [#254]
--   Don't send cookies with requests. [#261]
--   Expand and organize documentation. [#273]
-
-## 0.11.1
-
-### Bug Fixes
-
--   Await configuration before initializing network logging. [#243]
-
-## 0.11.0
-
-### New Features
-
--   Add native navigation bar overlay so modals better fit in. [#228]
--   Expand error reporting. [#234]
--   Log network activity. [#238]
-
-### Bug Fixes
-
--   Incorrect media attachment position. [#227]
--   Inline inserter opens native inserter. [#230]
-
-### Internal Changes
-
--   Improve demo app consistency. [#226]
--   Integrate the React Developer Tools. [#231]
--   Update project configuration, scripts, and documentation. [#229]
--   Improve Makefile. [#237]
--   Improve code quality. [#239]
--   Capture bridge message decoding failure details. [#240]
--   Organize editor setup. [#242]
-
-## 0.10.2
-
-### New Features
-
--   Discover Android demo app configuration. [#225]
-
-### Bug Fixes
-
--   Mitigate Android `ERR_UPLOAD_FILE_CHANGE` errors. [#224]
-
-### Internal Changes
-
--   Remove remote editor variant. [#210]
-
-## 0.10.1
-
-### Bug Fixes
-
--   Prevent crash from duplicate category pattern keys. [#223]
-
 ## 0.10.0
 
 ### Breaking Changes
@@ -201,323 +32,24 @@ _None_
 -   Increase deployment target to iOS 17. [#189]
 -   Remove unused `EditorNetworking`. [#208]
 
-### New Features
-
--   Add EditorViewModel. [#192]
--   Auto-focus when creating a new post. [#191]
--   Add block inserter flag and initial infrastructure. [#193]
--   Add basic block inserter features: grid, search, icons, ordering. [#196]
--   Native inserter: implement block insertion. [#199]
--   Add infrastructure for injecting media pickers. [#201]
--   Native inserter: add initial Photos integration. [#203]
--   Native inserter: add inline compact PhotosPicker. [#212]
--   Native inserter: show as popover on iPad. [#215]
--   Native inserter: patterns. [#207]
--   Native inserter: apply theme styles for pattern previews. [#218]
--   Native inserter: private pattern categories and localizable titles. [#219]
--   Native inserter: poor man internationalization. [#220]
--   Native inserter: add support for inserting existing site media. [#221]
--   Enable image resizing on mobile devices. [#213]
--   Block toolbar indicates scrollable area. [#214]
--   Bundled editor supports plugins. [#209]
--   Improve editor load resiliency. [#222]
--   Demo app navigates history state. [#187]
--   Demo editor toggles code editor mode. [#188]
--   Modernize Android demo app. [#194]
--   iOS demo app discovers remote editors. [#197]
-
-### Bug Fixes
-
--   Defer remote editor references to @wordpress modules. [#198]
--   Native inserter: fix SVG rendering. [#205]
--   Display drag-and-drop indicator. [#217]
-
-### Internal Changes
-
--   Remove unused code. [#190]
--   Remove unused AnyDecodable. [#200]
--   Refactor Sample App and Logging. [#202]
--   Improve local development server support. [#195]
--   Prevent log noise in test results. [#211]
-
-## 0.9.0
-
-### New Features
-
--   Theme styles supersede default styles. [#183]
--   Update iOS demo app navigation. [#184]
--   Update Android demo app navigation. [#185]
--   Send modal dialog state to host app. [#186]
-
-## 0.8.1
-
-### Bug Fixes
-
--   Prevent multiple Android WebView starts. [#175]
--   Block customization without editor settings. [#180]
--   Force visual editor mode to ensure consistency with native host UI. [#182]
-
-### Internal Changes
-
--   Move remote assets code into individual files. [#176]
--   Add Configuration Builder and tests. [#146]
--   Simplify iOS Settings. [#179]
-
 ## 0.8.0
 
 ### Breaking Changes
 
 -   Remove unnecessary WebView global configuration. [#172]
 
-### New Features
-
--   Expose autocomplete triggers and text insertion utility. [#165]
--   Forward original failed HTTP response to web view. [#167]
-
-### Bug Fixes
-
--   API requests utilize single auth mechanism. [#166]
--   Configure fetch requests occurring during editor initialization. [#168]
-
-### Internal Changes
-
--   Improve release script. [#163]
--   Improve debugging. [#164]
-
-## 0.7.0
-
-### New Features
-
--   Bridge AJAX requests to the REST API. [#161]
-
-### Bug Fixes
-
--   Prevent iOS crash in WebView navigations. [#159]
-
-### Internal Changes
-
--   Add Claude instructions. [#160]
-
 ## 0.6.0
 
 ### Breaking Changes
 
 -   Remove iOS cookie configuration. [#157]
 
-### Bug Fixes
-
--   Remove redundant trailing slash from API namespace configuration. [#158]
-
-## 0.5.0
-
-### New Features
-
--   Add cookie support. [#144]
--   Add multi-site support to Android demo app. [#155]
--   Android asset caching implementation. [#153]
-
-### Bug Fixes
-
--   Prevent reused Android WebView crash. [#152]
--   Fix WebView memory leak in GutenbergView. [#156]
-
-### Internal Changes
-
--   Change editor assets to the cache directory. [#154]
-
-## 0.4.1
-
-_Patch release — no user-facing changes._
-
-## 0.4.0
-
-### New Features
-
--   Support caching remote assets. [#148]
-
-### Internal Changes
-
--   Add instructions for remote editor. [#149]
--   Release process script and documentation. [#151]
-
-## 0.3.0
-
-### New Features
-
--   Internationalization. [#120]
--   Mark content outside of popovers inert. [#145]
--   Sync featured images to host app. [#147]
--   Enable image resizing on mobile devices. [#213]
-
-### Bug Fixes
-
--   Prevent block inserter horizontal overflow. [#127]
--   Android presents file picker for File block upload. [#128]
--   Mitigate Android text composition oddities. [#134]
--   Scrolling along edges breaks text editing. [#135]
--   Audio block iOS file picker compatibility. [#137]
--   Embed renders. [#140]
--   Prevent inline image crash. [#142]
-
-### Internal Changes
-
--   Avoid unnecessary editor assets requests. [#126]
--   Set up Vitest. [#131]
--   Update @wordpress/block-editor patch. [#132]
--   Assert useMediaUpload hook. [#141]
--   Revert to AGP 8.7.3. [#143]
-
-[#120]: https://github.com/wordpress-mobile/GutenbergKit/pull/120
-[#126]: https://github.com/wordpress-mobile/GutenbergKit/pull/126
-[#127]: https://github.com/wordpress-mobile/GutenbergKit/pull/127
-[#128]: https://github.com/wordpress-mobile/GutenbergKit/pull/128
-[#131]: https://github.com/wordpress-mobile/GutenbergKit/pull/131
-[#132]: https://github.com/wordpress-mobile/GutenbergKit/pull/132
-[#134]: https://github.com/wordpress-mobile/GutenbergKit/pull/134
-[#135]: https://github.com/wordpress-mobile/GutenbergKit/pull/135
-[#136]: https://github.com/wordpress-mobile/GutenbergKit/pull/136
-[#137]: https://github.com/wordpress-mobile/GutenbergKit/pull/137
-[#140]: https://github.com/wordpress-mobile/GutenbergKit/pull/140
-[#141]: https://github.com/wordpress-mobile/GutenbergKit/pull/141
-[#142]: https://github.com/wordpress-mobile/GutenbergKit/pull/142
-[#143]: https://github.com/wordpress-mobile/GutenbergKit/pull/143
-[#144]: https://github.com/wordpress-mobile/GutenbergKit/pull/144
-[#145]: https://github.com/wordpress-mobile/GutenbergKit/pull/145
-[#146]: https://github.com/wordpress-mobile/GutenbergKit/pull/146
-[#147]: https://github.com/wordpress-mobile/GutenbergKit/pull/147
-[#148]: https://github.com/wordpress-mobile/GutenbergKit/pull/148
-[#149]: https://github.com/wordpress-mobile/GutenbergKit/pull/149
-[#151]: https://github.com/wordpress-mobile/GutenbergKit/pull/151
-[#152]: https://github.com/wordpress-mobile/GutenbergKit/pull/152
-[#153]: https://github.com/wordpress-mobile/GutenbergKit/pull/153
-[#154]: https://github.com/wordpress-mobile/GutenbergKit/pull/154
-[#155]: https://github.com/wordpress-mobile/GutenbergKit/pull/155
-[#156]: https://github.com/wordpress-mobile/GutenbergKit/pull/156
 [#157]: https://github.com/wordpress-mobile/GutenbergKit/pull/157
-[#158]: https://github.com/wordpress-mobile/GutenbergKit/pull/158
-[#159]: https://github.com/wordpress-mobile/GutenbergKit/pull/159
-[#160]: https://github.com/wordpress-mobile/GutenbergKit/pull/160
-[#161]: https://github.com/wordpress-mobile/GutenbergKit/pull/161
-[#163]: https://github.com/wordpress-mobile/GutenbergKit/pull/163
-[#164]: https://github.com/wordpress-mobile/GutenbergKit/pull/164
-[#165]: https://github.com/wordpress-mobile/GutenbergKit/pull/165
-[#166]: https://github.com/wordpress-mobile/GutenbergKit/pull/166
-[#167]: https://github.com/wordpress-mobile/GutenbergKit/pull/167
-[#168]: https://github.com/wordpress-mobile/GutenbergKit/pull/168
 [#172]: https://github.com/wordpress-mobile/GutenbergKit/pull/172
-[#175]: https://github.com/wordpress-mobile/GutenbergKit/pull/175
-[#176]: https://github.com/wordpress-mobile/GutenbergKit/pull/176
-[#179]: https://github.com/wordpress-mobile/GutenbergKit/pull/179
-[#180]: https://github.com/wordpress-mobile/GutenbergKit/pull/180
 [#181]: https://github.com/wordpress-mobile/GutenbergKit/pull/181
-[#182]: https://github.com/wordpress-mobile/GutenbergKit/pull/182
-[#183]: https://github.com/wordpress-mobile/GutenbergKit/pull/183
-[#184]: https://github.com/wordpress-mobile/GutenbergKit/pull/184
-[#185]: https://github.com/wordpress-mobile/GutenbergKit/pull/185
-[#186]: https://github.com/wordpress-mobile/GutenbergKit/pull/186
-[#187]: https://github.com/wordpress-mobile/GutenbergKit/pull/187
-[#188]: https://github.com/wordpress-mobile/GutenbergKit/pull/188
 [#189]: https://github.com/wordpress-mobile/GutenbergKit/pull/189
-[#190]: https://github.com/wordpress-mobile/GutenbergKit/pull/190
-[#191]: https://github.com/wordpress-mobile/GutenbergKit/pull/191
-[#192]: https://github.com/wordpress-mobile/GutenbergKit/pull/192
-[#193]: https://github.com/wordpress-mobile/GutenbergKit/pull/193
-[#194]: https://github.com/wordpress-mobile/GutenbergKit/pull/194
-[#195]: https://github.com/wordpress-mobile/GutenbergKit/pull/195
-[#196]: https://github.com/wordpress-mobile/GutenbergKit/pull/196
-[#197]: https://github.com/wordpress-mobile/GutenbergKit/pull/197
-[#198]: https://github.com/wordpress-mobile/GutenbergKit/pull/198
-[#199]: https://github.com/wordpress-mobile/GutenbergKit/pull/199
-[#200]: https://github.com/wordpress-mobile/GutenbergKit/pull/200
-[#201]: https://github.com/wordpress-mobile/GutenbergKit/pull/201
-[#202]: https://github.com/wordpress-mobile/GutenbergKit/pull/202
-[#203]: https://github.com/wordpress-mobile/GutenbergKit/pull/203
-[#205]: https://github.com/wordpress-mobile/GutenbergKit/pull/205
-[#207]: https://github.com/wordpress-mobile/GutenbergKit/pull/207
 [#208]: https://github.com/wordpress-mobile/GutenbergKit/pull/208
-[#209]: https://github.com/wordpress-mobile/GutenbergKit/pull/209
-[#210]: https://github.com/wordpress-mobile/GutenbergKit/pull/210
-[#211]: https://github.com/wordpress-mobile/GutenbergKit/pull/211
-[#212]: https://github.com/wordpress-mobile/GutenbergKit/pull/212
-[#213]: https://github.com/wordpress-mobile/GutenbergKit/pull/213
-[#214]: https://github.com/wordpress-mobile/GutenbergKit/pull/214
-[#215]: https://github.com/wordpress-mobile/GutenbergKit/pull/215
-[#217]: https://github.com/wordpress-mobile/GutenbergKit/pull/217
-[#218]: https://github.com/wordpress-mobile/GutenbergKit/pull/218
-[#219]: https://github.com/wordpress-mobile/GutenbergKit/pull/219
-[#220]: https://github.com/wordpress-mobile/GutenbergKit/pull/220
-[#221]: https://github.com/wordpress-mobile/GutenbergKit/pull/221
-[#222]: https://github.com/wordpress-mobile/GutenbergKit/pull/222
-[#223]: https://github.com/wordpress-mobile/GutenbergKit/pull/223
-[#224]: https://github.com/wordpress-mobile/GutenbergKit/pull/224
-[#225]: https://github.com/wordpress-mobile/GutenbergKit/pull/225
-[#226]: https://github.com/wordpress-mobile/GutenbergKit/pull/226
-[#227]: https://github.com/wordpress-mobile/GutenbergKit/pull/227
-[#228]: https://github.com/wordpress-mobile/GutenbergKit/pull/228
-[#229]: https://github.com/wordpress-mobile/GutenbergKit/pull/229
-[#230]: https://github.com/wordpress-mobile/GutenbergKit/pull/230
-[#231]: https://github.com/wordpress-mobile/GutenbergKit/pull/231
-[#232]: https://github.com/wordpress-mobile/GutenbergKit/pull/232
-[#233]: https://github.com/wordpress-mobile/GutenbergKit/pull/233
-[#234]: https://github.com/wordpress-mobile/GutenbergKit/pull/234
-[#237]: https://github.com/wordpress-mobile/GutenbergKit/pull/237
-[#238]: https://github.com/wordpress-mobile/GutenbergKit/pull/238
-[#239]: https://github.com/wordpress-mobile/GutenbergKit/pull/239
-[#240]: https://github.com/wordpress-mobile/GutenbergKit/pull/240
-[#242]: https://github.com/wordpress-mobile/GutenbergKit/pull/242
-[#243]: https://github.com/wordpress-mobile/GutenbergKit/pull/243
 [#244]: https://github.com/wordpress-mobile/GutenbergKit/pull/244
-[#245]: https://github.com/wordpress-mobile/GutenbergKit/pull/245
 [#246]: https://github.com/wordpress-mobile/GutenbergKit/pull/246
-[#247]: https://github.com/wordpress-mobile/GutenbergKit/pull/247
-[#248]: https://github.com/wordpress-mobile/GutenbergKit/pull/248
-[#249]: https://github.com/wordpress-mobile/GutenbergKit/pull/249
-[#250]: https://github.com/wordpress-mobile/GutenbergKit/pull/250
-[#251]: https://github.com/wordpress-mobile/GutenbergKit/pull/251
 [#252]: https://github.com/wordpress-mobile/GutenbergKit/pull/252
-[#253]: https://github.com/wordpress-mobile/GutenbergKit/pull/253
-[#254]: https://github.com/wordpress-mobile/GutenbergKit/pull/254
-[#255]: https://github.com/wordpress-mobile/GutenbergKit/pull/255
-[#260]: https://github.com/wordpress-mobile/GutenbergKit/pull/260
-[#261]: https://github.com/wordpress-mobile/GutenbergKit/pull/261
-[#265]: https://github.com/wordpress-mobile/GutenbergKit/pull/265
-[#273]: https://github.com/wordpress-mobile/GutenbergKit/pull/273
-[#274]: https://github.com/wordpress-mobile/GutenbergKit/pull/274
-[#275]: https://github.com/wordpress-mobile/GutenbergKit/pull/275
-[#276]: https://github.com/wordpress-mobile/GutenbergKit/pull/276
-[#283]: https://github.com/wordpress-mobile/GutenbergKit/pull/283
-[#288]: https://github.com/wordpress-mobile/GutenbergKit/pull/288
-[#290]: https://github.com/wordpress-mobile/GutenbergKit/pull/290
-[#293]: https://github.com/wordpress-mobile/GutenbergKit/pull/293
-[#294]: https://github.com/wordpress-mobile/GutenbergKit/pull/294
-[#299]: https://github.com/wordpress-mobile/GutenbergKit/pull/299
-[#300]: https://github.com/wordpress-mobile/GutenbergKit/pull/300
-[#301]: https://github.com/wordpress-mobile/GutenbergKit/pull/301
-[#303]: https://github.com/wordpress-mobile/GutenbergKit/pull/303
-[#304]: https://github.com/wordpress-mobile/GutenbergKit/pull/304
-[#305]: https://github.com/wordpress-mobile/GutenbergKit/pull/305
-[#306]: https://github.com/wordpress-mobile/GutenbergKit/pull/306
-[#308]: https://github.com/wordpress-mobile/GutenbergKit/pull/308
-[#309]: https://github.com/wordpress-mobile/GutenbergKit/pull/309
-[#323]: https://github.com/wordpress-mobile/GutenbergKit/pull/323
-[#325]: https://github.com/wordpress-mobile/GutenbergKit/pull/325
 [#326]: https://github.com/wordpress-mobile/GutenbergKit/pull/326
-[#328]: https://github.com/wordpress-mobile/GutenbergKit/pull/328
-[#332]: https://github.com/wordpress-mobile/GutenbergKit/pull/332
-[#333]: https://github.com/wordpress-mobile/GutenbergKit/pull/333
-[#338]: https://github.com/wordpress-mobile/GutenbergKit/pull/338
-[#351]: https://github.com/wordpress-mobile/GutenbergKit/pull/351
-[#353]: https://github.com/wordpress-mobile/GutenbergKit/pull/353
-[#354]: https://github.com/wordpress-mobile/GutenbergKit/pull/354
-[#355]: https://github.com/wordpress-mobile/GutenbergKit/pull/355
-[#356]: https://github.com/wordpress-mobile/GutenbergKit/pull/356
-[#363]: https://github.com/wordpress-mobile/GutenbergKit/pull/363
-[#364]: https://github.com/wordpress-mobile/GutenbergKit/pull/364
-[#366]: https://github.com/wordpress-mobile/GutenbergKit/pull/366
-[#367]: https://github.com/wordpress-mobile/GutenbergKit/pull/367
-[#386]: https://github.com/wordpress-mobile/GutenbergKit/pull/386
-[#387]: https://github.com/wordpress-mobile/GutenbergKit/pull/387
-[#389]: https://github.com/wordpress-mobile/GutenbergKit/pull/389
-[#410]: https://github.com/wordpress-mobile/GutenbergKit/pull/410
-[#420]: https://github.com/wordpress-mobile/GutenbergKit/pull/420
-[#421]: https://github.com/wordpress-mobile/GutenbergKit/pull/421
diff --git a/bin/release.sh b/bin/release.sh
index 54874e33e..9fb3743bc 100755
--- a/bin/release.sh
+++ b/bin/release.sh
@@ -274,18 +274,6 @@ update_changelog() {
 \\
 ### Breaking Changes\\
 \\
-_None_\\
-\\
-### New Features\\
-\\
-_None_\\
-\\
-### Bug Fixes\\
-\\
-_None_\\
-\\
-### Internal Changes\\
-\\
 _None_" "$changelog"
 
     print_success "CHANGELOG.md updated for version $version"
diff --git a/docs/code/developer-workflows.md b/docs/code/developer-workflows.md
index b34560cf0..5f3752b24 100644
--- a/docs/code/developer-workflows.md
+++ b/docs/code/developer-workflows.md
@@ -38,7 +38,7 @@ When creating a pull request:
 1. **Use the PR template**: The template in `.github/PULL_REQUEST_TEMPLATE.md` provides the required structure.
 2. **Assign a label**: Use `gh label list` to see available labels and select the most relevant one.
 3. **Follow Conventional Commits**: The PR title should use the same format as commit messages above.
-4. **Update the changelog**: If your PR contains user-facing changes, add an entry to the appropriate section under `## Trunk` in `CHANGELOG.md`. Breaking changes are especially important to capture.
+4. **Update the changelog**: If your PR contains a breaking change, add an entry under `## Trunk` in `CHANGELOG.md` describing what changed and its impact on consumers.
 
 ### Automatic Labeling
 
diff --git a/docs/releases.md b/docs/releases.md
index b19197778..1940bfe81 100644
--- a/docs/releases.md
+++ b/docs/releases.md
@@ -41,14 +41,9 @@ After the release is created, it is ready for integration into the WordPress app
 
 ## Changelog
 
-The project maintains a `CHANGELOG.md` file at the repository root. It uses a **Trunk** section at the top where unreleased changes are staged under four categories:
+The project maintains a `CHANGELOG.md` file at the repository root that tracks **breaking changes** to help consumers plan upgrades. For the full list of changes in each release, see [GitHub Releases](https://github.com/wordpress-mobile/GutenbergKit/releases) — release notes are auto-generated from PR titles and labels (see [Release Notes](#release-notes) below).
 
--   **Breaking Changes** — API removals, behavior changes, platform requirement increases
--   **New Features** — new capabilities
--   **Bug Fixes** — bug fixes
--   **Internal Changes** — refactors, tooling, tests, docs
-
-When you merge a PR that contains user-facing changes, add an entry to the appropriate section in Trunk. Breaking changes are especially important to capture — they help consumers of the library plan upgrades.
+`CHANGELOG.md` uses a **Trunk** section at the top where upcoming breaking changes are staged before release. When you merge a PR that contains a breaking change, add an entry to the Trunk section describing what changed and its impact on consumers.
 
 During a release, the script automatically renames the Trunk section to the new version number and creates a fresh empty Trunk section.
 

From a89a0ff64ef38712ef1e2372f6c7719be7e4c84e Mon Sep 17 00:00:00 2001
From: Jeremy Massel <1123407+jkmassel@users.noreply.github.com>
Date: Mon, 13 Apr 2026 15:05:17 -0600
Subject: [PATCH 3/8] ci: add PR validation check for type label or
 Conventional Commits title

Ensures every PR has either a valid Conventional Commits prefix in the
title (which triggers automatic labeling via label-pr.yml) or a manually
applied [Type] label. This prevents PRs from falling through the cracks
in auto-generated release notes.
---
 .github/workflows/validate-pr.yml | 67 +++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 .github/workflows/validate-pr.yml

diff --git a/.github/workflows/validate-pr.yml b/.github/workflows/validate-pr.yml
new file mode 100644
index 000000000..e13a357f0
--- /dev/null
+++ b/.github/workflows/validate-pr.yml
@@ -0,0 +1,67 @@
+name: Validate PR
+
+on:
+    pull_request_target:
+        types: [opened, edited, labeled, unlabeled]
+
+jobs:
+    validate:
+        runs-on: ubuntu-latest
+        permissions:
+            pull-requests: read
+        steps:
+            - name: Ensure PR has a valid type
+              uses: actions/github-script@v7
+              with:
+                  script: |
+                      const title = context.payload.pull_request.title;
+                      const prefixMatch = title.match(/^(\w+)(?:\([^)]*\))?(!)?:/);
+                      const prefix = prefixMatch?.[1]?.toLowerCase();
+
+                      const validPrefixes = [
+                          'feat', 'fix', 'perf', 'test', 'docs',
+                          'build', 'ci', 'refactor', 'task', 'chore', 'style',
+                      ];
+
+                      const hasValidPrefix = validPrefixes.includes(prefix);
+                      const isBreaking = prefixMatch?.[2] === '!';
+
+                      const { data: labels } = await github.rest.issues.listLabelsOnIssue({
+                          owner: context.repo.owner,
+                          repo: context.repo.repo,
+                          issue_number: context.payload.pull_request.number,
+                      });
+
+                      const typeLabels = [
+                          '[Type] Enhancement',
+                          '[Type] Bug',
+                          '[Type] Performance',
+                          '[Type] Automated Testing',
+                          '[Type] Developer Documentation',
+                          '[Type] Build Tooling',
+                          '[Type] Task',
+                          '[Type] Breaking Change',
+                          '[Type] Regression',
+                      ];
+
+                      const hasTypeLabel = labels.some((l) => typeLabels.includes(l.name));
+
+                      if (hasValidPrefix || hasTypeLabel) {
+                          const method = hasValidPrefix ? 'Conventional Commits prefix' : 'type label';
+                          core.info(`✅ PR has a valid type via ${method}`);
+
+                          if (isBreaking && !labels.some((l) => l.name === '[Type] Breaking Change')) {
+                              core.warning(
+                                  'PR title uses the ! breaking change marker but does not have the [Type] Breaking Change label. ' +
+                                  'The label-pr workflow should apply it automatically — if it has not, apply it manually.'
+                              );
+                          }
+
+                          return;
+                      }
+
+                      core.setFailed(
+                          'PR must have either a Conventional Commits title prefix (e.g. feat:, fix:, docs:) ' +
+                          'or a [Type] label applied manually.\n\n' +
+                          'See docs/code/developer-workflows.md for details.'
+                      );

From 6e455da5cdb1c6dc6361456ee8e72585728cb360 Mon Sep 17 00:00:00 2001
From: Jeremy Massel <1123407+jkmassel@users.noreply.github.com>
Date: Mon, 13 Apr 2026 15:10:42 -0600
Subject: [PATCH 4/8] ci: remove redundant breaking change warning from PR
 validation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The label-pr workflow already applies the [Type] Breaking Change label
when it sees ! in the title — no need to warn about it separately.
---
 .github/workflows/validate-pr.yml | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/.github/workflows/validate-pr.yml b/.github/workflows/validate-pr.yml
index e13a357f0..e5cc5c88f 100644
--- a/.github/workflows/validate-pr.yml
+++ b/.github/workflows/validate-pr.yml
@@ -49,14 +49,6 @@ jobs:
                       if (hasValidPrefix || hasTypeLabel) {
                           const method = hasValidPrefix ? 'Conventional Commits prefix' : 'type label';
                           core.info(`✅ PR has a valid type via ${method}`);
-
-                          if (isBreaking && !labels.some((l) => l.name === '[Type] Breaking Change')) {
-                              core.warning(
-                                  'PR title uses the ! breaking change marker but does not have the [Type] Breaking Change label. ' +
-                                  'The label-pr workflow should apply it automatically — if it has not, apply it manually.'
-                              );
-                          }
-
                           return;
                       }
 

From 75f39edbff6b0792b70a68da26c54b3aabe36353 Mon Sep 17 00:00:00 2001
From: Jeremy Massel <1123407+jkmassel@users.noreply.github.com>
Date: Mon, 13 Apr 2026 15:45:09 -0600
Subject: [PATCH 5/8] docs: remove CHANGELOG.md in favor of GitHub Releases

The new PR validation check ensures every PR has either a Conventional
Commits title or a type label, so GitHub Releases will reliably capture
breaking changes going forward. A manual CHANGELOG is redundant.
---
 CHANGELOG.md                     | 55 --------------------------------
 bin/release.sh                   | 35 --------------------
 docs/code/developer-workflows.md |  1 -
 docs/releases.md                 | 25 ++-------------
 4 files changed, 2 insertions(+), 114 deletions(-)
 delete mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
deleted file mode 100644
index e78e77473..000000000
--- a/CHANGELOG.md
+++ /dev/null
@@ -1,55 +0,0 @@
-# GutenbergKit CHANGELOG
-
-This file tracks **breaking changes** to help consumers plan upgrades. For the full list of changes in each release, see [GitHub Releases](https://github.com/wordpress-mobile/GutenbergKit/releases).
-
----
-
-## Trunk
-
-### Breaking Changes
-
-_None_
-
-## 0.15.0
-
-### Breaking Changes
-
--   Move editor loading into the library — callers no longer manage the editor load lifecycle. [#326]
--   AJAX requests now use token authentication instead of cookie-based auth. [#181]
-
-## 0.12.0
-
-### Breaking Changes
-
--   Update to Swift 6 — requires Swift 6 compiler toolchain. [#252]
--   Disable cookies in EditorService. [#246]
--   Remove unused `setup` method from public API. [#244]
-
-## 0.10.0
-
-### Breaking Changes
-
--   Increase deployment target to iOS 17. [#189]
--   Remove unused `EditorNetworking`. [#208]
-
-## 0.8.0
-
-### Breaking Changes
-
--   Remove unnecessary WebView global configuration. [#172]
-
-## 0.6.0
-
-### Breaking Changes
-
--   Remove iOS cookie configuration. [#157]
-
-[#157]: https://github.com/wordpress-mobile/GutenbergKit/pull/157
-[#172]: https://github.com/wordpress-mobile/GutenbergKit/pull/172
-[#181]: https://github.com/wordpress-mobile/GutenbergKit/pull/181
-[#189]: https://github.com/wordpress-mobile/GutenbergKit/pull/189
-[#208]: https://github.com/wordpress-mobile/GutenbergKit/pull/208
-[#244]: https://github.com/wordpress-mobile/GutenbergKit/pull/244
-[#246]: https://github.com/wordpress-mobile/GutenbergKit/pull/246
-[#252]: https://github.com/wordpress-mobile/GutenbergKit/pull/252
-[#326]: https://github.com/wordpress-mobile/GutenbergKit/pull/326
diff --git a/bin/release.sh b/bin/release.sh
index 9fb3743bc..c00b60b50 100755
--- a/bin/release.sh
+++ b/bin/release.sh
@@ -247,38 +247,6 @@ build_project() {
     print_success "Build completed successfully"
 }
 
-# Function to update CHANGELOG.md for a release
-update_changelog() {
-    local version=$1
-
-    print_status "Updating CHANGELOG.md..."
-
-    if [ "$DRY_RUN" = "true" ]; then
-        return
-    fi
-
-    local changelog="CHANGELOG.md"
-
-    if [ ! -f "$changelog" ]; then
-        print_warning "CHANGELOG.md not found, skipping changelog update"
-        return
-    fi
-
-    # Replace "## Trunk" with the new version heading, then prepend a fresh Trunk section
-    sed -i '' "s/^## Trunk$/## $version/" "$changelog"
-
-    # Insert the new Trunk section after the horizontal rule
-    sed -i '' "/^---$/a\\
-\\
-## Trunk\\
-\\
-### Breaking Changes\\
-\\
-_None_" "$changelog"
-
-    print_success "CHANGELOG.md updated for version $version"
-}
-
 # Function to commit changes
 commit_changes() {
     local version=$1
@@ -407,9 +375,6 @@ main() {
         new_version=$(get_current_version)
     fi
 
-    update_changelog "$new_version"
-    echo
-
     build_project
     echo
 
diff --git a/docs/code/developer-workflows.md b/docs/code/developer-workflows.md
index 5f3752b24..305158ca7 100644
--- a/docs/code/developer-workflows.md
+++ b/docs/code/developer-workflows.md
@@ -38,7 +38,6 @@ When creating a pull request:
 1. **Use the PR template**: The template in `.github/PULL_REQUEST_TEMPLATE.md` provides the required structure.
 2. **Assign a label**: Use `gh label list` to see available labels and select the most relevant one.
 3. **Follow Conventional Commits**: The PR title should use the same format as commit messages above.
-4. **Update the changelog**: If your PR contains a breaking change, add an entry under `## Trunk` in `CHANGELOG.md` describing what changed and its impact on consumers.
 
 ### Automatic Labeling
 
diff --git a/docs/releases.md b/docs/releases.md
index 1940bfe81..dd82f1068 100644
--- a/docs/releases.md
+++ b/docs/releases.md
@@ -30,35 +30,14 @@ The script:
 1. Checks that your working directory is clean
 1. Ensures required dependencies are installed
 1. Increments the version number[^1]
-1. Updates `CHANGELOG.md` — moves the Trunk section to the new version and creates a fresh Trunk section
 1. Builds the project[^2]
 1. Commits changes
 1. Creates a Git tag
 1. Pushes to `origin/trunk` with tags
-1. Creates a GitHub release: `gh release create vX.X.X --generate-notes --title "X.X.X"`
+1. Creates a GitHub release
+1. Creates a new release on GitHub: `gh release create vX.X.X --generate-notes --title "X.X.X"`
 
 After the release is created, it is ready for integration into the WordPress app.
 
-## Changelog
-
-The project maintains a `CHANGELOG.md` file at the repository root that tracks **breaking changes** to help consumers plan upgrades. For the full list of changes in each release, see [GitHub Releases](https://github.com/wordpress-mobile/GutenbergKit/releases) — release notes are auto-generated from PR titles and labels (see [Release Notes](#release-notes) below).
-
-`CHANGELOG.md` uses a **Trunk** section at the top where upcoming breaking changes are staged before release. When you merge a PR that contains a breaking change, add an entry to the Trunk section describing what changed and its impact on consumers.
-
-During a release, the script automatically renames the Trunk section to the new version number and creates a fresh empty Trunk section.
-
-## Release Notes
-
-GitHub automatically generates release notes when a release is created. Notes are organized into the following categories based on PR labels:
-
--   **Breaking Changes** — `[Type] Breaking Change`
--   **Features & Enhancements** — `[Type] Enhancement`
--   **Bug Fixes** — `[Type] Bug`, `[Type] Regression`
--   **Other Changes** — everything else (excludes `[Type] Automated Testing`, `[Type] Build Tooling`, `[Type] Task`, `[Type] Developer Documentation`, and `dependencies`)
-
-Dependabot dependency bump PRs are excluded automatically.
-
-PRs are labeled automatically based on their Conventional Commits title prefix. See the [Developer Workflows](./code/developer-workflows.md) guide for details on the labeling rules.
-
 [^1]: We increment the version before building and without tagging so that (1) the correct version number is included in the build's [error reporting metadata](https://github.com/wordpress-mobile/GutenbergKit/blob/8195901ec8883125dcfa102abf2b6a2a3962af3e/src/utils/exception-parser.js#L99) and (2) the Git tag includes the latest build output.
 [^2]: CI tasks create new Android builds for each commit. However, such infrastructure is not yet in place for iOS. Therefore, we must manually create and commit the iOS build.

From 0396c85913014a332a0d47f922a5f944f6e61da8 Mon Sep 17 00:00:00 2001
From: Jeremy Massel <1123407+jkmassel@users.noreply.github.com>
Date: Wed, 15 Apr 2026 11:43:42 -0600
Subject: [PATCH 6/8] ci: use pull_request trigger for PR validation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

pull_request_target only runs the workflow from the default branch, so
the check can't fire until it's merged — a chicken-and-egg problem.

This workflow only needs read access (title + labels), so pull_request
is the correct trigger. pull_request_target is only needed for the
label-pr workflow which writes labels.
---
 .github/workflows/validate-pr.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/validate-pr.yml b/.github/workflows/validate-pr.yml
index e5cc5c88f..2f6a330f8 100644
--- a/.github/workflows/validate-pr.yml
+++ b/.github/workflows/validate-pr.yml
@@ -1,7 +1,7 @@
 name: Validate PR
 
 on:
-    pull_request_target:
+    pull_request:
         types: [opened, edited, labeled, unlabeled]
 
 jobs:

From f2e2a03a6ff76379565e875c9f29cfb0b7acd0b0 Mon Sep 17 00:00:00 2001
From: Jeremy Massel <1123407+jkmassel@users.noreply.github.com>
Date: Wed, 15 Apr 2026 12:18:07 -0600
Subject: [PATCH 7/8] ci: add synchronize trigger to PR validation workflow

Force-pushes (e.g. rebases) fire the synchronize event, not opened or
edited. Without this, the check wouldn't re-run after a rebase.
---
 .github/workflows/validate-pr.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/validate-pr.yml b/.github/workflows/validate-pr.yml
index 2f6a330f8..65c488648 100644
--- a/.github/workflows/validate-pr.yml
+++ b/.github/workflows/validate-pr.yml
@@ -2,7 +2,7 @@ name: Validate PR
 
 on:
     pull_request:
-        types: [opened, edited, labeled, unlabeled]
+        types: [opened, edited, synchronize, labeled, unlabeled]
 
 jobs:
     validate:

From 2679c4d1ac5d8ebcfa531589e66f1ab3c60670b2 Mon Sep 17 00:00:00 2001
From: Oguz Kocer <oguz.kocer@automattic.com>
Date: Mon, 13 Apr 2026 19:52:38 -0400
Subject: [PATCH 8/8] Test PR 423 'invalid prefix'

---
 test-pr-423-invalid-prefix.txt | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 test-pr-423-invalid-prefix.txt

diff --git a/test-pr-423-invalid-prefix.txt b/test-pr-423-invalid-prefix.txt
new file mode 100644
index 000000000..e69de29bb