ci: fix release body cascade notes (#129)

ark-65 · web-flow · commit e238376bd43a · 2026-04-29T16:03:52.000+08:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,10 @@ English | [中文文档](CHANGELOG.zh-CN.md)
 
 ## [Unreleased]
 
+### 🤖 CI
+
+- Keep cascade-only package maintenance notes out of GitHub Release bodies and preserve direct package changelog wording.
+
 ## 0.2.2 (2026-04-29)
 
 ### 🤖 CI
@@ -14,27 +18,37 @@ English | [中文文档](CHANGELOG.zh-CN.md)
 
 ### 🧪 Tests
 
-- Migrated package tests from Karma/Jasmine to Angular unit-test with Vitest.
+- Added Vitest unit tests for core package.
 
 ### @zhongmiao/ngx-lowcode-designer@0.2.2
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Updated @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ### @zhongmiao/ngx-lowcode-materials@0.2.2
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Updated @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ### @zhongmiao/ngx-lowcode-puzzle-adapter@0.2.2
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Updated @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ### @zhongmiao/ngx-lowcode-renderer@0.2.2
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Updated @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ### @zhongmiao/ngx-lowcode-testing@0.2.2
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Updated @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/CHANGELOG.zh-CN.md b/CHANGELOG.zh-CN.md
@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+### 🤖 CI
+
+- GitHub Release body 不再包含纯级联包的维护文案，并保留直接变更包的原始 changelog 文案。
+
 ## 0.2.2 (2026-04-29)
 
 ### 🤖 CI
@@ -18,23 +22,33 @@
 
 ### @zhongmiao/ngx-lowcode-designer@0.2.2
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 因本次联动发布，将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 更新到 0.2.2。
 
 ### @zhongmiao/ngx-lowcode-materials@0.2.2
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 因本次联动发布，将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 更新到 0.2.2。
 
 ### @zhongmiao/ngx-lowcode-puzzle-adapter@0.2.2
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 因本次联动发布，将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 更新到 0.2.2。
 
 ### @zhongmiao/ngx-lowcode-renderer@0.2.2
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 因本次联动发布，将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 更新到 0.2.2。
 
 ### @zhongmiao/ngx-lowcode-testing@0.2.2
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 因本次联动发布，将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 更新到 0.2.2。
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-core/CHANGELOG.md b/projects/ngx-lowcode-core/CHANGELOG.md
@@ -2,11 +2,15 @@
 
 ## [Unreleased]
 
+### 🔧 Changed
+
+- Added a core package release validation note for checking generated release bodies.
+
 ## 0.2.2 (2026-04-29)
 
 ### 🧪 Tests
 
-- Migrated package tests from Karma/Jasmine to Angular unit-test with Vitest.
+- Added Vitest unit tests for core package.
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-core/CHANGELOG.zh-CN.md b/projects/ngx-lowcode-core/CHANGELOG.zh-CN.md
@@ -4,6 +4,10 @@
 
 ## [Unreleased]
 
+### 🔧 变更
+
+- 新增 core 包发布验证说明，用于检查生成的 release body。
+
 ## 0.2.2 (2026-04-29)
 
 ### 🧪 测试
diff --git a/projects/ngx-lowcode-designer/CHANGELOG.md b/projects/ngx-lowcode-designer/CHANGELOG.md
@@ -4,7 +4,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Aligned @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-designer/CHANGELOG.zh-CN.md b/projects/ngx-lowcode-designer/CHANGELOG.zh-CN.md
@@ -6,7 +6,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 在本次联动发布中将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 对齐到 0.2.2。
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-materials/CHANGELOG.md b/projects/ngx-lowcode-materials/CHANGELOG.md
@@ -4,7 +4,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Aligned @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-materials/CHANGELOG.zh-CN.md b/projects/ngx-lowcode-materials/CHANGELOG.zh-CN.md
@@ -6,7 +6,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 在本次联动发布中将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 对齐到 0.2.2。
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-puzzle-adapter/CHANGELOG.md b/projects/ngx-lowcode-puzzle-adapter/CHANGELOG.md
@@ -4,7 +4,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Aligned @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-puzzle-adapter/CHANGELOG.zh-CN.md b/projects/ngx-lowcode-puzzle-adapter/CHANGELOG.zh-CN.md
@@ -6,7 +6,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 在本次联动发布中将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 对齐到 0.2.2。
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-renderer/CHANGELOG.md b/projects/ngx-lowcode-renderer/CHANGELOG.md
@@ -4,7 +4,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Aligned @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-renderer/CHANGELOG.zh-CN.md b/projects/ngx-lowcode-renderer/CHANGELOG.zh-CN.md
@@ -6,7 +6,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 在本次联动发布中将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 对齐到 0.2.2。
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-testing/CHANGELOG.md b/projects/ngx-lowcode-testing/CHANGELOG.md
@@ -4,7 +4,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): align peerDependencies for @zhongmiao/ngx-lowcode-core to 0.2.2 in release cascade.
+### 🔧 Changed
+
+- Aligned @zhongmiao/ngx-lowcode-core peer dependency from 0.2.1 to 0.2.2 for the release cascade.
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/projects/ngx-lowcode-testing/CHANGELOG.zh-CN.md b/projects/ngx-lowcode-testing/CHANGELOG.zh-CN.md
@@ -6,7 +6,9 @@
 
 ## 0.2.2 (2026-04-29)
 
-- chore(release): 在本次联动发布中将 @zhongmiao/ngx-lowcode-core 的 peerDependencies 对齐到 0.2.2。
+### 🔧 变更
+
+- 在本次联动发布中将 @zhongmiao/ngx-lowcode-core peer dependency 从 0.2.1 对齐到 0.2.2。
 
 ## 0.2.1 (2026-04-29)
 
diff --git a/scripts/release/apply-release-batch-versions.mjs b/scripts/release/apply-release-batch-versions.mjs
@@ -77,6 +77,20 @@ const appendBulletToUnreleased = (filePath, bullet) => {
   lines.splice(insertionIndex, 0, ...insertLines);
   fs.writeFileSync(filePath, `${lines.join('\n').replace(/\n+$/g, '\n')}\n`, 'utf8');
 };
+const formatPeerDependencyChangeEn = (change) =>
+  change.from
+    ? `- Aligned ${change.name} peer dependency from ${change.from} to ${change.to} for the release cascade.`
+    : `- Aligned ${change.name} peer dependency to ${change.to} for the release cascade.`;
+const formatPeerDependencyChangeZh = (change) =>
+  change.from
+    ? `- 在本次联动发布中将 ${change.name} peer dependency 从 ${change.from} 对齐到 ${change.to}。`
+    : `- 在本次联动发布中将 ${change.name} peer dependency 对齐到 ${change.to}。`;
+const cascadePackageNotesEn = (changes) => `### 🔧 Changed
+
+${changes.map(formatPeerDependencyChangeEn).join('\n')}`;
+const cascadePackageNotesZh = (changes) => `### 🔧 变更
+
+${changes.map(formatPeerDependencyChangeZh).join('\n')}`;
 const aggregatePackage = JSON.parse(fs.readFileSync(aggregatePackagePath, 'utf8'));
 aggregatePackage.version = aggregate.version;
 aggregatePackage.dependencies = aggregatePackage.dependencies || {};
@@ -96,6 +110,7 @@ for (const pkg of changedPackages) {
   }
 
   const packageJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'));
+  const sourcePeerDependencies = { ...(packageJson.peerDependencies || {}) };
   packageJson.version = packageVersion;
   packageJson.peerDependencies = packageJson.peerDependencies || {};
   for (const peerName of Object.keys(packageJson.peerDependencies)) {
@@ -107,16 +122,18 @@ for (const pkg of changedPackages) {
   fs.writeFileSync(pkgJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, 'utf8');
 
   if (pkg.selectionReason === 'cascade_dependency') {
-    const triggerList =
-      Array.isArray(pkg.triggeredBy) && pkg.triggeredBy.length > 0 ? pkg.triggeredBy : ['direct package'];
     const changelogEnPath = pkg.changelogPathEn;
     const changelogZhPath = pkg.changelogPathZh;
-    const bulletEn =
-      pkg.unreleasedEn ||
-      `- chore(release): align peerDependencies for ${triggerList.join(', ')} to ${packageVersion} in release cascade.`;
-    const bulletZh =
-      pkg.unreleasedZh ||
-      `- chore(release): 在本次联动发布中将 ${triggerList.join('、')} 的 peerDependencies 对齐到 ${packageVersion}。`;
+    const peerDependencyChanges =
+      Array.isArray(pkg.peerDependencyChanges) && pkg.peerDependencyChanges.length > 0
+        ? pkg.peerDependencyChanges
+        : (Array.isArray(pkg.triggeredBy) ? pkg.triggeredBy : []).map((dependencyName) => ({
+            name: dependencyName,
+            from: sourcePeerDependencies[dependencyName] || '',
+            to: targetVersionByPackage.get(dependencyName) || aggregate.version
+          }));
+    const bulletEn = pkg.unreleasedEn || cascadePackageNotesEn(peerDependencyChanges);
+    const bulletZh = pkg.unreleasedZh || cascadePackageNotesZh(peerDependencyChanges);
 
     if (changelogEnPath) {
       ensureUnreleasedSection(changelogEnPath, '# Changelog');
diff --git a/scripts/release/compose-draft-from-unreleased.mjs b/scripts/release/compose-draft-from-unreleased.mjs
@@ -100,10 +100,20 @@ while (queue.length > 0) {
   }
 }
 
-const releaseTemplateEn = (triggerPackages, version) =>
-  `- chore(release): align peerDependencies for ${triggerPackages.join(', ')} to ${version} in release cascade.`;
-const releaseTemplateZh = (triggerPackages, version) =>
-  `- chore(release): 在本次联动发布中将 ${triggerPackages.join('、')} 的 peerDependencies 对齐到 ${version}。`;
+const formatPeerDependencyChangeEn = (change) =>
+  change.from
+    ? `- Aligned ${change.name} peer dependency from ${change.from} to ${change.to} for the release cascade.`
+    : `- Aligned ${change.name} peer dependency to ${change.to} for the release cascade.`;
+const formatPeerDependencyChangeZh = (change) =>
+  change.from
+    ? `- 在本次联动发布中将 ${change.name} peer dependency 从 ${change.from} 对齐到 ${change.to}。`
+    : `- 在本次联动发布中将 ${change.name} peer dependency 对齐到 ${change.to}。`;
+const cascadePackageNotesEn = (changes) => `### 🔧 Changed
+
+${changes.map(formatPeerDependencyChangeEn).join('\n')}`;
+const cascadePackageNotesZh = (changes) => `### 🔧 变更
+
+${changes.map(formatPeerDependencyChangeZh).join('\n')}`;
 
 const cascadePackages = [];
 for (const [pkgName, roots] of cascadeRoots) {
@@ -113,8 +123,12 @@ for (const [pkgName, roots] of cascadeRoots) {
   const triggeredBy = [...roots].sort();
   const sourceVersion = pkg.version;
   const targetVersion = aggregate.version;
-  const syntheticEn = releaseTemplateEn(triggeredBy, targetVersion);
-  const syntheticZh = releaseTemplateZh(triggeredBy, targetVersion);
+  const hasRealUnreleasedNotes = Boolean(pkg.unreleasedEn);
+  const peerDependencyChanges = triggeredBy.map((dependencyName) => ({
+    name: dependencyName,
+    from: pkg.peerDependencies?.[dependencyName] || '',
+    to: targetVersion
+  }));
 
   cascadePackages.push({
     ...pkg,
@@ -124,8 +138,10 @@ for (const [pkgName, roots] of cascadeRoots) {
     selectionReason: 'cascade_dependency',
     willRewriteInSandbox: sourceVersion !== targetVersion,
     triggeredBy,
-    unreleasedEn: pkg.unreleasedEn || syntheticEn,
-    unreleasedZh: pkg.unreleasedZh || syntheticZh
+    peerDependencyChanges,
+    hasRealUnreleasedNotes,
+    unreleasedEn: pkg.unreleasedEn || cascadePackageNotesEn(peerDependencyChanges),
+    unreleasedZh: pkg.unreleasedZh || cascadePackageNotesZh(peerDependencyChanges)
   });
 }
 
diff --git a/scripts/release/finalize-unreleased-changelogs.mjs b/scripts/release/finalize-unreleased-changelogs.mjs
diff --git a/scripts/release/write-release-plan.mjs b/scripts/release/write-release-plan.mjs
