diff --git a/.changeset/comments-flag.md b/.changeset/comments-flag.md
deleted file mode 100644
index 26d70904..00000000
--- a/.changeset/comments-flag.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-'dotenv-diff': minor
----
-
-add `--comment-warnings` flag (opt-in, off by default) that warns about `.env.example` keys lacking a documenting comment.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index cf14e808..5c148f04 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,19 @@
 # Changelog
 
+<!-- changesets: comments-flag.md -->
+## 2026-07-26
+
+### Highlights
+- add `--comment-warnings` flag (opt-in, off by default) that warns about `.env.example` keys lacking a documenting comment.
+
+### Package Releases
+- dotenv-diff: minor
+
+### Full Changelog
+Package | Release type
+--- | ---
+dotenv-diff | minor
+
 <!-- changesets: diffmatrix-prototype-keys.md,gentle-expire-rollover.md,inconsistent-naming-dedup-collision.md,quiet-plants-fuzz.md,skip-commented-usages-markers.md,sveltekit-lib-server-false-positive.md,tidy-secrets-report.md,wise-entropy-codepoints.md -->
 ## 2026-07-24
 
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 40c9bb57..20ddca23 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## 3.2.0
+
+### Minor Changes
+
+- 4b8fa66: add `--comment-warnings` flag (opt-in, off by default) that warns about `.env.example` keys lacking a documenting comment.
+
 ## 3.1.2
 
 ### Patch Changes
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 4750b641..542dbf16 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "dotenv-diff",
-  "version": "3.1.2",
+  "version": "3.2.0",
   "type": "module",
   "description": "Detects environment variable issues, usage, and potential security risks.",
   "bin": {