@qlover/fe-release 5.0.5 → 5.1.0

package/dist/cli.cjs

@@ -28,7 +28,7 @@ var import_commander = require("commander");
 
 // package.json
 var description = "A tool for releasing front-end projects, supporting multiple release modes and configurations, simplifying the release process and improving efficiency.";
-var version = "5.0.5";
+var version = "5.1.0";
 
 // src/cli.ts
 var import_semver = __toESM(require("semver"), 1);
@@ -82,6 +82,10 @@ var releaseJson = {
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
+    /** GitHub release title template (createRelease mode) */
+    releaseName: "${name}@${version}",
+    /** Path prefixes skipped when creating GitHub releases */
+    ignoreReleasePaths: [],
     label: {
       name: "CI-Release",
       color: "1A7F37",
@@ -592,6 +596,9 @@ function workspaceVersionSummary(workspace) {
 function shouldProcessWorkspace(workspace, ignoreNonUpdatedPackages) {
   return !(ignoreNonUpdatedPackages && workspace.dependencyRelease);
 }
+function isPrivateWorkspace(workspace) {
+  return workspace.packageJson?.private === true;
+}
 function readJson(path) {
   const packageJsonContent = (0, import_fs.readFileSync)(path, "utf-8");
   return JSON.parse(packageJsonContent);
@@ -1733,9 +1740,18 @@ ${workspaces?.map((workspace) => workspace.toString()).join("\n")}`
       this.logDryRun("Would run: changeset publish, publish packages and tags");
       const preview = this.mergeWorkspaces(workspaces);
       this.context.setWorkspaces(preview);
-      const previewTags = preview.filter(
-        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && workspace.tagName
+      const previewTags = this.collectPushableReleaseTags(preview);
+      const privateTags = preview.filter(
+        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
       ).map((workspace) => workspace.tagName);
+      if (privateTags.length > 0) {
+        this.logDryRun(
+          `Would create local tag(s) for private package(s):
+${[
+            ...new Set(privateTags)
+          ].map((tag) => `  ${tag}`).join("\n")}`
+        );
+      }
       this.logDryRun(
         previewTags.length === 0 ? "Would push release tag(s) from workspace.tagName: none" : `Would push release tag(s) from workspace.tagName:
 ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
@@ -1749,37 +1765,106 @@ ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
     if (workspaces.length > 0) {
       this.syncWorkspaces(workspaces);
     }
+    const syncedWorkspaces = this.context.workspaces ?? workspaces;
+    await this.step({
+      label: "Create Private Package Tags",
+      task: () => this.ensurePrivateReleaseTags(syncedWorkspaces)
+    });
     await this.step({
       label: "Push Release Tags",
-      task: () => this.pushWorkspaceReleaseTags(this.context.workspaces ?? workspaces)
+      task: () => this.pushWorkspaceReleaseTags(syncedWorkspaces)
     });
   }
   /**
-   * Push release tags from synced workspaces' `tagName` fields.
+   * Collect tag names that should be pushed after `changeset publish`.
    *
-   * `changeset publish` only creates tags locally. After {@link syncWorkspaces},
-   * each publishable workspace should already have `tagName` (e.g. `pkg@1.2.3`).
+   * Includes public packages (tagged by changesets) and private packages
+   * (tagged by {@link ensurePrivateReleaseTags}). Skips dependency-release
+   * workspaces.
    */
-  async pushWorkspaceReleaseTags(workspaces) {
+  collectPushableReleaseTags(workspaces) {
     const tags = workspaces.filter(
       (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && !!workspace.tagName
     ).map((workspace) => workspace.tagName);
-    const uniqueTags = [...new Set(tags)];
+    return [...new Set(tags)];
+  }
+  /**
+   * List local git tag names (short refs under `refs/tags/`).
+   */
+  async listLocalTags() {
+    const output = await this.shell.exec(
+      'git for-each-ref --format="%(refname:short)" refs/tags/',
+      { dryRun: false, silent: true }
+    );
+    const tags = output.split("\n").map((line) => line.trim()).filter(Boolean);
+    return new Set(tags);
+  }
+  /**
+   * Create local git tags for private packages after `changeset publish`.
+   *
+   * Changesets skips npm publish and tagging for `private: true` packages.
+   * Release still needs those tags as changelog baselines, so create them here.
+   */
+  async ensurePrivateReleaseTags(workspaces) {
+    const privateWorkspaces = workspaces.filter(
+      (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
+    );
+    if (privateWorkspaces.length === 0) {
+      return;
+    }
+    const localTags = await this.listLocalTags();
+    for (const workspace of privateWorkspaces) {
+      const tagName = workspace.tagName;
+      if (localTags.has(tagName)) {
+        this.logger.debug(`Private package tag already exists: ${tagName}`);
+        continue;
+      }
+      this.logger.info(
+        `Create local release tag for private package: ${tagName}`
+      );
+      await this.shell.exec(["git", "tag", tagName]);
+      localTags.add(tagName);
+    }
+  }
+  /**
+   * Push release tags from synced workspaces' `tagName` fields.
+   *
+   * After {@link syncWorkspaces} and {@link ensurePrivateReleaseTags}, push
+   * tags that exist as local refs. Missing public-package tags are skipped
+   * (changeset may have skipped publish); they are not invented here.
+   */
+  async pushWorkspaceReleaseTags(workspaces) {
+    const uniqueTags = this.collectPushableReleaseTags(workspaces);
     if (uniqueTags.length === 0) {
       this.logger.warn(
         "No workspace.tagName found after publish sync; skip tag push"
       );
       return;
     }
+    const localTags = await this.listLocalTags();
+    const existingTags = uniqueTags.filter((tag) => localTags.has(tag));
+    const missingTags = uniqueTags.filter((tag) => !localTags.has(tag));
+    if (missingTags.length > 0) {
+      this.logger.warn(
+        `Skip push for missing local tag(s):
+${missingTags.map((tag) => `  ${tag}`).join("\n")}`
+      );
+    }
+    if (existingTags.length === 0) {
+      this.logger.warn(
+        "No local release tags found to push after publish; skip tag push"
+      );
+      return;
+    }
     this.logger.info(
-      `Pushing ${uniqueTags.length} release tag(s) to origin:
-${uniqueTags.map((tag) => `  ${tag}`).join("\n")}`
+      `Pushing ${existingTags.length} release tag(s) to origin:
+${existingTags.map((tag) => `  ${tag}`).join("\n")}`
     );
     await this.shell.exec([
       "git",
       "push",
       "origin",
-      ...uniqueTags.map((tag) => `"refs/tags/${tag}"`)
+      ...existingTags.map((tag) => `"refs/tags/${tag}"`)
     ]);
   }
   syncWorkspaces(workspaces) {
@@ -2664,7 +2749,7 @@ var GithubManager = class {
    */
   getOctokitReleaseOptions(options) {
     const {
-      releaseName,
+      releaseName = releaseJson.github.releaseName,
       draft = false,
       preRelease = false,
       autoGenerate = false,
@@ -2673,7 +2758,7 @@ var GithubManager = class {
       discussionCategoryName = void 0
     } = this.context.getParameters("github");
     const name = releaseName;
-    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes));
+    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes ?? ""));
     return {
       name,
       make_latest: makeLatest.toString(),
@@ -3437,6 +3522,7 @@ var ReleaseFormatter = class {
 var Github = class extends GitBase {
   releaseFormatter;
   githubManager;
+  pather = new Pather();
   constructor(context, props = {}) {
     super(context, "github", props);
     this.releaseFormatter = new ReleaseFormatter(
@@ -3448,6 +3534,9 @@ var Github = class extends GitBase {
   get mode() {
     return this.config.mode || releaseJson.github.mode;
   }
+  get ignoreReleasePaths() {
+    return this.config.ignoreReleasePaths ?? [...releaseJson.github.ignoreReleasePaths];
+  }
   async onBefore() {
     await super.onBefore();
     await this.githubManager.validateToken();
@@ -3473,6 +3562,9 @@ var Github = class extends GitBase {
           if (workspace.dependencyRelease) {
             return workspace;
           }
+          if (this.mode === "createRelease" && this.isIgnoredReleasePath(workspace)) {
+            return workspace;
+          }
           return githubChangelog.enrichWorkspaceChangelog(workspace);
         })
       )
@@ -3481,6 +3573,13 @@ var Github = class extends GitBase {
   }
   async onSuccess() {
     const workspaces = this.context.requireWorkspaces();
+    if (this.mode === "createRelease") {
+      await this.step({
+        label: "Create GitHub Releases",
+        task: () => this.createGithubReleases(workspaces)
+      });
+      return;
+    }
     const releaseBranchResult = await this.step({
       label: "Create Release Branch",
       task: () => this.createReleaseBranch(workspaces)
@@ -3497,6 +3596,63 @@ var Github = class extends GitBase {
     }
     await this.handleReleasePullRequest(workspaces, releaseBranchResult);
   }
+  /**
+   * Whether this workspace path is under an ignoreReleasePaths entry.
+   */
+  isIgnoredReleasePath(workspace) {
+    const ignorePaths = this.ignoreReleasePaths;
+    if (ignorePaths.length === 0) {
+      return false;
+    }
+    return ignorePaths.some(
+      (ignorePath) => this.pather.isSubPath(workspace.path, ignorePath)
+    );
+  }
+  /**
+   * Workspaces that should receive a GitHub Release in createRelease mode.
+   *
+   * Requires `tagName`. Skips dependency-release packages and paths matched
+   * by {@link GithubProps.ignoreReleasePaths}. Private packages are included
+   * when they have a tag.
+   */
+  getReleaseWorkspaces(workspaces) {
+    return workspaces.filter((workspace) => {
+      if (!workspace.tagName) {
+        return false;
+      }
+      if (workspace.dependencyRelease) {
+        return false;
+      }
+      if (this.isIgnoredReleasePath(workspace)) {
+        this.logger.info(
+          `Skip GitHub Release for ignored path: ${workspace.path} (${workspace.tagName})`
+        );
+        return false;
+      }
+      return true;
+    });
+  }
+  /**
+   * Create a GitHub Release for each eligible workspace.
+   *
+   * Release notes use the enriched workspace changelog from `onExec`.
+   */
+  async createGithubReleases(workspaces) {
+    const releaseWorkspaces = this.getReleaseWorkspaces(workspaces);
+    if (releaseWorkspaces.length === 0) {
+      this.logger.warn("No workspaces eligible for GitHub Release creation");
+      return;
+    }
+    this.logger.info(
+      `Creating GitHub Releases (${releaseWorkspaces.length}):
+${releaseWorkspaces.map((w) => `  ${w.tagName}`).join("\n")}`
+    );
+    await Promise.all(
+      releaseWorkspaces.map(
+        (workspace) => this.githubManager.createRelease(workspace)
+      )
+    );
+  }
   /**
    * Create the release PR and optionally auto-merge it.
    *
@@ -3852,6 +4008,22 @@ function programArgs() {
   ).option(
     "--workspaces.skip",
     "Skip the Workspaces plugin"
+  ).option(
+    "--github.mode <mode>",
+    "Github mode: createPR (default) or createRelease (fe-config: release.github.mode)",
+    (value) => {
+      if (value !== "createPR" && value !== "createRelease") {
+        throw new Error(
+          'Invalid github.mode. Must be "createPR" or "createRelease"'
+        );
+      }
+      return value;
+    },
+    "createPR"
+  ).option(
+    "--github.ignore-release-paths <paths>",
+    "Path prefixes to skip when creating GitHub Releases, comma-separated (fe-config: release.github.ignoreReleasePaths)",
+    splitWithComma
   ).option(
     "--github.skip [lifecycle]",
     "Skip the Github plugin (no value) or a lifecycle such as onSuccess"

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 
 // package.json
 var description = "A tool for releasing front-end projects, supporting multiple release modes and configurations, simplifying the release process and improving efficiency.";
-var version = "5.0.5";
+var version = "5.1.0";
 
 // src/cli.ts
 import semver from "semver";
@@ -59,6 +59,10 @@ var releaseJson = {
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
+    /** GitHub release title template (createRelease mode) */
+    releaseName: "${name}@${version}",
+    /** Path prefixes skipped when creating GitHub releases */
+    ignoreReleasePaths: [],
     label: {
       name: "CI-Release",
       color: "1A7F37",
@@ -572,6 +576,9 @@ function workspaceVersionSummary(workspace) {
 function shouldProcessWorkspace(workspace, ignoreNonUpdatedPackages) {
   return !(ignoreNonUpdatedPackages && workspace.dependencyRelease);
 }
+function isPrivateWorkspace(workspace) {
+  return workspace.packageJson?.private === true;
+}
 function readJson(path) {
   const packageJsonContent = readFileSync(path, "utf-8");
   return JSON.parse(packageJsonContent);
@@ -1713,9 +1720,18 @@ ${workspaces?.map((workspace) => workspace.toString()).join("\n")}`
       this.logDryRun("Would run: changeset publish, publish packages and tags");
       const preview = this.mergeWorkspaces(workspaces);
       this.context.setWorkspaces(preview);
-      const previewTags = preview.filter(
-        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && workspace.tagName
+      const previewTags = this.collectPushableReleaseTags(preview);
+      const privateTags = preview.filter(
+        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
       ).map((workspace) => workspace.tagName);
+      if (privateTags.length > 0) {
+        this.logDryRun(
+          `Would create local tag(s) for private package(s):
+${[
+            ...new Set(privateTags)
+          ].map((tag) => `  ${tag}`).join("\n")}`
+        );
+      }
       this.logDryRun(
         previewTags.length === 0 ? "Would push release tag(s) from workspace.tagName: none" : `Would push release tag(s) from workspace.tagName:
 ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
@@ -1729,37 +1745,106 @@ ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
     if (workspaces.length > 0) {
       this.syncWorkspaces(workspaces);
     }
+    const syncedWorkspaces = this.context.workspaces ?? workspaces;
+    await this.step({
+      label: "Create Private Package Tags",
+      task: () => this.ensurePrivateReleaseTags(syncedWorkspaces)
+    });
     await this.step({
       label: "Push Release Tags",
-      task: () => this.pushWorkspaceReleaseTags(this.context.workspaces ?? workspaces)
+      task: () => this.pushWorkspaceReleaseTags(syncedWorkspaces)
     });
   }
   /**
-   * Push release tags from synced workspaces' `tagName` fields.
+   * Collect tag names that should be pushed after `changeset publish`.
    *
-   * `changeset publish` only creates tags locally. After {@link syncWorkspaces},
-   * each publishable workspace should already have `tagName` (e.g. `pkg@1.2.3`).
+   * Includes public packages (tagged by changesets) and private packages
+   * (tagged by {@link ensurePrivateReleaseTags}). Skips dependency-release
+   * workspaces.
    */
-  async pushWorkspaceReleaseTags(workspaces) {
+  collectPushableReleaseTags(workspaces) {
     const tags = workspaces.filter(
       (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && !!workspace.tagName
     ).map((workspace) => workspace.tagName);
-    const uniqueTags = [...new Set(tags)];
+    return [...new Set(tags)];
+  }
+  /**
+   * List local git tag names (short refs under `refs/tags/`).
+   */
+  async listLocalTags() {
+    const output = await this.shell.exec(
+      'git for-each-ref --format="%(refname:short)" refs/tags/',
+      { dryRun: false, silent: true }
+    );
+    const tags = output.split("\n").map((line) => line.trim()).filter(Boolean);
+    return new Set(tags);
+  }
+  /**
+   * Create local git tags for private packages after `changeset publish`.
+   *
+   * Changesets skips npm publish and tagging for `private: true` packages.
+   * Release still needs those tags as changelog baselines, so create them here.
+   */
+  async ensurePrivateReleaseTags(workspaces) {
+    const privateWorkspaces = workspaces.filter(
+      (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
+    );
+    if (privateWorkspaces.length === 0) {
+      return;
+    }
+    const localTags = await this.listLocalTags();
+    for (const workspace of privateWorkspaces) {
+      const tagName = workspace.tagName;
+      if (localTags.has(tagName)) {
+        this.logger.debug(`Private package tag already exists: ${tagName}`);
+        continue;
+      }
+      this.logger.info(
+        `Create local release tag for private package: ${tagName}`
+      );
+      await this.shell.exec(["git", "tag", tagName]);
+      localTags.add(tagName);
+    }
+  }
+  /**
+   * Push release tags from synced workspaces' `tagName` fields.
+   *
+   * After {@link syncWorkspaces} and {@link ensurePrivateReleaseTags}, push
+   * tags that exist as local refs. Missing public-package tags are skipped
+   * (changeset may have skipped publish); they are not invented here.
+   */
+  async pushWorkspaceReleaseTags(workspaces) {
+    const uniqueTags = this.collectPushableReleaseTags(workspaces);
     if (uniqueTags.length === 0) {
       this.logger.warn(
         "No workspace.tagName found after publish sync; skip tag push"
       );
       return;
     }
+    const localTags = await this.listLocalTags();
+    const existingTags = uniqueTags.filter((tag) => localTags.has(tag));
+    const missingTags = uniqueTags.filter((tag) => !localTags.has(tag));
+    if (missingTags.length > 0) {
+      this.logger.warn(
+        `Skip push for missing local tag(s):
+${missingTags.map((tag) => `  ${tag}`).join("\n")}`
+      );
+    }
+    if (existingTags.length === 0) {
+      this.logger.warn(
+        "No local release tags found to push after publish; skip tag push"
+      );
+      return;
+    }
     this.logger.info(
-      `Pushing ${uniqueTags.length} release tag(s) to origin:
-${uniqueTags.map((tag) => `  ${tag}`).join("\n")}`
+      `Pushing ${existingTags.length} release tag(s) to origin:
+${existingTags.map((tag) => `  ${tag}`).join("\n")}`
     );
     await this.shell.exec([
       "git",
       "push",
       "origin",
-      ...uniqueTags.map((tag) => `"refs/tags/${tag}"`)
+      ...existingTags.map((tag) => `"refs/tags/${tag}"`)
     ]);
   }
   syncWorkspaces(workspaces) {
@@ -2644,7 +2729,7 @@ var GithubManager = class {
    */
   getOctokitReleaseOptions(options) {
     const {
-      releaseName,
+      releaseName = releaseJson.github.releaseName,
       draft = false,
       preRelease = false,
       autoGenerate = false,
@@ -2653,7 +2738,7 @@ var GithubManager = class {
       discussionCategoryName = void 0
     } = this.context.getParameters("github");
     const name = releaseName;
-    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes));
+    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes ?? ""));
     return {
       name,
       make_latest: makeLatest.toString(),
@@ -3417,6 +3502,7 @@ var ReleaseFormatter = class {
 var Github = class extends GitBase {
   releaseFormatter;
   githubManager;
+  pather = new Pather();
   constructor(context, props = {}) {
     super(context, "github", props);
     this.releaseFormatter = new ReleaseFormatter(
@@ -3428,6 +3514,9 @@ var Github = class extends GitBase {
   get mode() {
     return this.config.mode || releaseJson.github.mode;
   }
+  get ignoreReleasePaths() {
+    return this.config.ignoreReleasePaths ?? [...releaseJson.github.ignoreReleasePaths];
+  }
   async onBefore() {
     await super.onBefore();
     await this.githubManager.validateToken();
@@ -3453,6 +3542,9 @@ var Github = class extends GitBase {
           if (workspace.dependencyRelease) {
             return workspace;
           }
+          if (this.mode === "createRelease" && this.isIgnoredReleasePath(workspace)) {
+            return workspace;
+          }
           return githubChangelog.enrichWorkspaceChangelog(workspace);
         })
       )
@@ -3461,6 +3553,13 @@ var Github = class extends GitBase {
   }
   async onSuccess() {
     const workspaces = this.context.requireWorkspaces();
+    if (this.mode === "createRelease") {
+      await this.step({
+        label: "Create GitHub Releases",
+        task: () => this.createGithubReleases(workspaces)
+      });
+      return;
+    }
     const releaseBranchResult = await this.step({
       label: "Create Release Branch",
       task: () => this.createReleaseBranch(workspaces)
@@ -3477,6 +3576,63 @@ var Github = class extends GitBase {
     }
     await this.handleReleasePullRequest(workspaces, releaseBranchResult);
   }
+  /**
+   * Whether this workspace path is under an ignoreReleasePaths entry.
+   */
+  isIgnoredReleasePath(workspace) {
+    const ignorePaths = this.ignoreReleasePaths;
+    if (ignorePaths.length === 0) {
+      return false;
+    }
+    return ignorePaths.some(
+      (ignorePath) => this.pather.isSubPath(workspace.path, ignorePath)
+    );
+  }
+  /**
+   * Workspaces that should receive a GitHub Release in createRelease mode.
+   *
+   * Requires `tagName`. Skips dependency-release packages and paths matched
+   * by {@link GithubProps.ignoreReleasePaths}. Private packages are included
+   * when they have a tag.
+   */
+  getReleaseWorkspaces(workspaces) {
+    return workspaces.filter((workspace) => {
+      if (!workspace.tagName) {
+        return false;
+      }
+      if (workspace.dependencyRelease) {
+        return false;
+      }
+      if (this.isIgnoredReleasePath(workspace)) {
+        this.logger.info(
+          `Skip GitHub Release for ignored path: ${workspace.path} (${workspace.tagName})`
+        );
+        return false;
+      }
+      return true;
+    });
+  }
+  /**
+   * Create a GitHub Release for each eligible workspace.
+   *
+   * Release notes use the enriched workspace changelog from `onExec`.
+   */
+  async createGithubReleases(workspaces) {
+    const releaseWorkspaces = this.getReleaseWorkspaces(workspaces);
+    if (releaseWorkspaces.length === 0) {
+      this.logger.warn("No workspaces eligible for GitHub Release creation");
+      return;
+    }
+    this.logger.info(
+      `Creating GitHub Releases (${releaseWorkspaces.length}):
+${releaseWorkspaces.map((w) => `  ${w.tagName}`).join("\n")}`
+    );
+    await Promise.all(
+      releaseWorkspaces.map(
+        (workspace) => this.githubManager.createRelease(workspace)
+      )
+    );
+  }
   /**
    * Create the release PR and optionally auto-merge it.
    *
@@ -3832,6 +3988,22 @@ function programArgs() {
   ).option(
     "--workspaces.skip",
     "Skip the Workspaces plugin"
+  ).option(
+    "--github.mode <mode>",
+    "Github mode: createPR (default) or createRelease (fe-config: release.github.mode)",
+    (value) => {
+      if (value !== "createPR" && value !== "createRelease") {
+        throw new Error(
+          'Invalid github.mode. Must be "createPR" or "createRelease"'
+        );
+      }
+      return value;
+    },
+    "createPR"
+  ).option(
+    "--github.ignore-release-paths <paths>",
+    "Path prefixes to skip when creating GitHub Releases, comma-separated (fe-config: release.github.ignoreReleasePaths)",
+    splitWithComma
   ).option(
     "--github.skip [lifecycle]",
     "Skip the Github plugin (no value) or a lifecycle such as onSuccess"

package/dist/index.cjs

@@ -79,6 +79,10 @@ var releaseJson = {
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
+    /** GitHub release title template (createRelease mode) */
+    releaseName: "${name}@${version}",
+    /** Path prefixes skipped when creating GitHub releases */
+    ignoreReleasePaths: [],
     label: {
       name: "CI-Release",
       color: "1A7F37",
@@ -597,6 +601,9 @@ function workspaceVersionSummary(workspace) {
 function shouldProcessWorkspace(workspace, ignoreNonUpdatedPackages) {
   return !(ignoreNonUpdatedPackages && workspace.dependencyRelease);
 }
+function isPrivateWorkspace(workspace) {
+  return workspace.packageJson?.private === true;
+}
 function readJson(path) {
   const packageJsonContent = (0, import_fs.readFileSync)(path, "utf-8");
   return JSON.parse(packageJsonContent);
@@ -1738,9 +1745,18 @@ ${workspaces?.map((workspace) => workspace.toString()).join("\n")}`
       this.logDryRun("Would run: changeset publish, publish packages and tags");
       const preview = this.mergeWorkspaces(workspaces);
       this.context.setWorkspaces(preview);
-      const previewTags = preview.filter(
-        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && workspace.tagName
+      const previewTags = this.collectPushableReleaseTags(preview);
+      const privateTags = preview.filter(
+        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
       ).map((workspace) => workspace.tagName);
+      if (privateTags.length > 0) {
+        this.logDryRun(
+          `Would create local tag(s) for private package(s):
+${[
+            ...new Set(privateTags)
+          ].map((tag) => `  ${tag}`).join("\n")}`
+        );
+      }
       this.logDryRun(
         previewTags.length === 0 ? "Would push release tag(s) from workspace.tagName: none" : `Would push release tag(s) from workspace.tagName:
 ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
@@ -1754,37 +1770,106 @@ ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
     if (workspaces.length > 0) {
       this.syncWorkspaces(workspaces);
     }
+    const syncedWorkspaces = this.context.workspaces ?? workspaces;
+    await this.step({
+      label: "Create Private Package Tags",
+      task: () => this.ensurePrivateReleaseTags(syncedWorkspaces)
+    });
     await this.step({
       label: "Push Release Tags",
-      task: () => this.pushWorkspaceReleaseTags(this.context.workspaces ?? workspaces)
+      task: () => this.pushWorkspaceReleaseTags(syncedWorkspaces)
     });
   }
   /**
-   * Push release tags from synced workspaces' `tagName` fields.
+   * Collect tag names that should be pushed after `changeset publish`.
    *
-   * `changeset publish` only creates tags locally. After {@link syncWorkspaces},
-   * each publishable workspace should already have `tagName` (e.g. `pkg@1.2.3`).
+   * Includes public packages (tagged by changesets) and private packages
+   * (tagged by {@link ensurePrivateReleaseTags}). Skips dependency-release
+   * workspaces.
    */
-  async pushWorkspaceReleaseTags(workspaces) {
+  collectPushableReleaseTags(workspaces) {
     const tags = workspaces.filter(
       (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && !!workspace.tagName
     ).map((workspace) => workspace.tagName);
-    const uniqueTags = [...new Set(tags)];
+    return [...new Set(tags)];
+  }
+  /**
+   * List local git tag names (short refs under `refs/tags/`).
+   */
+  async listLocalTags() {
+    const output = await this.shell.exec(
+      'git for-each-ref --format="%(refname:short)" refs/tags/',
+      { dryRun: false, silent: true }
+    );
+    const tags = output.split("\n").map((line) => line.trim()).filter(Boolean);
+    return new Set(tags);
+  }
+  /**
+   * Create local git tags for private packages after `changeset publish`.
+   *
+   * Changesets skips npm publish and tagging for `private: true` packages.
+   * Release still needs those tags as changelog baselines, so create them here.
+   */
+  async ensurePrivateReleaseTags(workspaces) {
+    const privateWorkspaces = workspaces.filter(
+      (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
+    );
+    if (privateWorkspaces.length === 0) {
+      return;
+    }
+    const localTags = await this.listLocalTags();
+    for (const workspace of privateWorkspaces) {
+      const tagName = workspace.tagName;
+      if (localTags.has(tagName)) {
+        this.logger.debug(`Private package tag already exists: ${tagName}`);
+        continue;
+      }
+      this.logger.info(
+        `Create local release tag for private package: ${tagName}`
+      );
+      await this.shell.exec(["git", "tag", tagName]);
+      localTags.add(tagName);
+    }
+  }
+  /**
+   * Push release tags from synced workspaces' `tagName` fields.
+   *
+   * After {@link syncWorkspaces} and {@link ensurePrivateReleaseTags}, push
+   * tags that exist as local refs. Missing public-package tags are skipped
+   * (changeset may have skipped publish); they are not invented here.
+   */
+  async pushWorkspaceReleaseTags(workspaces) {
+    const uniqueTags = this.collectPushableReleaseTags(workspaces);
     if (uniqueTags.length === 0) {
       this.logger.warn(
         "No workspace.tagName found after publish sync; skip tag push"
       );
       return;
     }
+    const localTags = await this.listLocalTags();
+    const existingTags = uniqueTags.filter((tag) => localTags.has(tag));
+    const missingTags = uniqueTags.filter((tag) => !localTags.has(tag));
+    if (missingTags.length > 0) {
+      this.logger.warn(
+        `Skip push for missing local tag(s):
+${missingTags.map((tag) => `  ${tag}`).join("\n")}`
+      );
+    }
+    if (existingTags.length === 0) {
+      this.logger.warn(
+        "No local release tags found to push after publish; skip tag push"
+      );
+      return;
+    }
     this.logger.info(
-      `Pushing ${uniqueTags.length} release tag(s) to origin:
-${uniqueTags.map((tag) => `  ${tag}`).join("\n")}`
+      `Pushing ${existingTags.length} release tag(s) to origin:
+${existingTags.map((tag) => `  ${tag}`).join("\n")}`
     );
     await this.shell.exec([
       "git",
       "push",
       "origin",
-      ...uniqueTags.map((tag) => `"refs/tags/${tag}"`)
+      ...existingTags.map((tag) => `"refs/tags/${tag}"`)
     ]);
   }
   syncWorkspaces(workspaces) {
@@ -2669,7 +2754,7 @@ var GithubManager = class {
    */
   getOctokitReleaseOptions(options) {
     const {
-      releaseName,
+      releaseName = releaseJson.github.releaseName,
       draft = false,
       preRelease = false,
       autoGenerate = false,
@@ -2678,7 +2763,7 @@ var GithubManager = class {
       discussionCategoryName = void 0
     } = this.context.getParameters("github");
     const name = releaseName;
-    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes));
+    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes ?? ""));
     return {
       name,
       make_latest: makeLatest.toString(),
@@ -3442,6 +3527,7 @@ var ReleaseFormatter = class {
 var Github = class extends GitBase {
   releaseFormatter;
   githubManager;
+  pather = new Pather();
   constructor(context, props = {}) {
     super(context, "github", props);
     this.releaseFormatter = new ReleaseFormatter(
@@ -3453,6 +3539,9 @@ var Github = class extends GitBase {
   get mode() {
     return this.config.mode || releaseJson.github.mode;
   }
+  get ignoreReleasePaths() {
+    return this.config.ignoreReleasePaths ?? [...releaseJson.github.ignoreReleasePaths];
+  }
   async onBefore() {
     await super.onBefore();
     await this.githubManager.validateToken();
@@ -3478,6 +3567,9 @@ var Github = class extends GitBase {
           if (workspace.dependencyRelease) {
             return workspace;
           }
+          if (this.mode === "createRelease" && this.isIgnoredReleasePath(workspace)) {
+            return workspace;
+          }
           return githubChangelog.enrichWorkspaceChangelog(workspace);
         })
       )
@@ -3486,6 +3578,13 @@ var Github = class extends GitBase {
   }
   async onSuccess() {
     const workspaces = this.context.requireWorkspaces();
+    if (this.mode === "createRelease") {
+      await this.step({
+        label: "Create GitHub Releases",
+        task: () => this.createGithubReleases(workspaces)
+      });
+      return;
+    }
     const releaseBranchResult = await this.step({
       label: "Create Release Branch",
       task: () => this.createReleaseBranch(workspaces)
@@ -3502,6 +3601,63 @@ var Github = class extends GitBase {
     }
     await this.handleReleasePullRequest(workspaces, releaseBranchResult);
   }
+  /**
+   * Whether this workspace path is under an ignoreReleasePaths entry.
+   */
+  isIgnoredReleasePath(workspace) {
+    const ignorePaths = this.ignoreReleasePaths;
+    if (ignorePaths.length === 0) {
+      return false;
+    }
+    return ignorePaths.some(
+      (ignorePath) => this.pather.isSubPath(workspace.path, ignorePath)
+    );
+  }
+  /**
+   * Workspaces that should receive a GitHub Release in createRelease mode.
+   *
+   * Requires `tagName`. Skips dependency-release packages and paths matched
+   * by {@link GithubProps.ignoreReleasePaths}. Private packages are included
+   * when they have a tag.
+   */
+  getReleaseWorkspaces(workspaces) {
+    return workspaces.filter((workspace) => {
+      if (!workspace.tagName) {
+        return false;
+      }
+      if (workspace.dependencyRelease) {
+        return false;
+      }
+      if (this.isIgnoredReleasePath(workspace)) {
+        this.logger.info(
+          `Skip GitHub Release for ignored path: ${workspace.path} (${workspace.tagName})`
+        );
+        return false;
+      }
+      return true;
+    });
+  }
+  /**
+   * Create a GitHub Release for each eligible workspace.
+   *
+   * Release notes use the enriched workspace changelog from `onExec`.
+   */
+  async createGithubReleases(workspaces) {
+    const releaseWorkspaces = this.getReleaseWorkspaces(workspaces);
+    if (releaseWorkspaces.length === 0) {
+      this.logger.warn("No workspaces eligible for GitHub Release creation");
+      return;
+    }
+    this.logger.info(
+      `Creating GitHub Releases (${releaseWorkspaces.length}):
+${releaseWorkspaces.map((w) => `  ${w.tagName}`).join("\n")}`
+    );
+    await Promise.all(
+      releaseWorkspaces.map(
+        (workspace) => this.githubManager.createRelease(workspace)
+      )
+    );
+  }
   /**
    * Create the release PR and optionally auto-merge it.
    *

package/dist/index.d.ts

@@ -253,7 +253,7 @@ interface ReleaseFormatterConfig {
 
 /**
  * @module Github
- * @description GitHub changelog enrichment and release PR plugin
+ * @description GitHub changelog enrichment, release PR, and GitHub Release plugin
  *
  * Third plugin in the default release pipeline (after {@link Workspaces} and
  * {@link ChangesetVersion}). Extends {@link GitBase} for git operations and
@@ -262,33 +262,48 @@ interface ReleaseFormatterConfig {
  * Pipeline phases:
  * - **onBefore**: validate GitHub token; seed {@link ReleaseFormatter} context
  * - **onExec**: enrich workspace changelogs with PR/commit links via {@link GithubChangelog}
- * - **onSuccess**: create release branch, commit, push, and open PR (unless skipped)
+ * - **onSuccess**:
+ *   - `createPR` — create release branch, commit, push, and open PR (unless skipped)
+ *   - `createRelease` — create a GitHub Release per workspace (tag + changelog body)
  *
- * Release branch flow:
+ * Release branch flow (`createPR`):
  * 1. `ReleaseFormatter.getReleaseBranch()` — derive branch and tag names from templates
  * 2. Create branch from `sourceBranch`, commit version/changelog changes, push
  * 3. Open PR with formatted title/body and optional labels
  * 4. Auto-merge when `autoMergeReleasePr` is enabled
  *
+ * GitHub Release flow (`createRelease`):
+ * 1. Filter workspaces with `tagName`, skipping `dependencyRelease` and
+ *    paths matched by {@link GithubProps.ignoreReleasePaths}
+ * 2. Call {@link GithubManager.createRelease} with workspace changelog as notes
+ *
  * @example Skip PR creation (local dry-run)
  * ```bash
  * fe-release --github.skip-create-release-pr --dry-run
  * ```
  *
+ * @example Publish + GitHub Releases (ignore examples)
+ * ```bash
+ * fe-release --changesetVersion.mode publish \
+ *   --github.mode createRelease \
+ *   --github.ignore-release-paths examples
+ * ```
+ *
  * @example fe-config label and merge settings
  * ```json
  * {
  *   "release": {
  *     "github": {
  *       "autoMergeReleasePr": false,
- *       "label": { "name": "CI-Release" }
+ *       "label": { "name": "CI-Release" },
+ *       "ignoreReleasePaths": ["examples"]
  *     }
  *   }
  * }
  * ```
  */
 
-type GithubMode = 'createPR';
+type GithubMode = 'createPR' | 'createRelease';
 type GithubLabel = {
     /**
      * Hexadecimal color code for label appearance
@@ -345,8 +360,8 @@ interface GithubProps extends ReleaseFormatterConfig, GitBaseProps {
     /**
      * Plugin work mode
      *
-     * Currently only `createPR` is supported: enrich changelogs in `onExec`,
-     * then create release branch and PR in `onSuccess`.
+     * - `createPR`: enrich changelogs in `onExec`, then create release branch and PR in `onSuccess`
+     * - `createRelease`: enrich changelogs in `onExec`, then create GitHub Releases in `onSuccess`
      *
      * @default `'createPR'`
      */
@@ -423,6 +438,22 @@ interface GithubProps extends ReleaseFormatterConfig, GitBaseProps {
      * @default false
      */
     skipCreateReleasePr?: boolean;
+    /**
+     * Workspace path prefixes to skip when creating GitHub Releases.
+     *
+     * Matched with segment-aware path containment (e.g. `examples` skips
+     * `examples/react-seed`). Applies only in `createRelease` mode.
+     *
+     * CLI: `--github.ignore-release-paths`
+     * fe-config: `release.github.ignoreReleasePaths`
+     *
+     * @default `[]`
+     * @example
+     * ```json
+     * { "ignoreReleasePaths": ["examples", "apps/docs"] }
+     * ```
+     */
+    ignoreReleasePaths?: string[];
     /**
      * Configuration for release pull request labels
      *
@@ -856,9 +887,10 @@ interface ChangeLogInterface {
  * - **onSuccess**: run version and/or publish flow based on `mode`
  *
  * Publish flow (`mode: 'publish'` or second half of `'both'`):
- * 1. Run `changeset publish` (npm publish + local `git tag` only)
+ * 1. Run `changeset publish` (npm publish + local `git tag` for public packages)
  * 2. Sync workspaces from disk so `tagName` is set from the release version
- * 3. Push `workspace.tagName` refs to `origin`
+ * 3. Create local tags for `private` packages (changesets skips tagging them)
+ * 4. Push `workspace.tagName` refs that exist locally to `origin`
  *
  * Version flow (`mode: 'version'` or first half of `'both'`):
  * 1. Write `.changeset/*.md` files for directly changed packages only
@@ -992,11 +1024,31 @@ declare class ChangesetVersion extends ScriptPlugin<ReleaseContext, ChangesetVer
     protected logDryRun(message: string): void;
     protected runVersionFlow(): Promise<void>;
     protected runChangesetPublish(): Promise<void>;
+    /**
+     * Collect tag names that should be pushed after `changeset publish`.
+     *
+     * Includes public packages (tagged by changesets) and private packages
+     * (tagged by {@link ensurePrivateReleaseTags}). Skips dependency-release
+     * workspaces.
+     */
+    protected collectPushableReleaseTags(workspaces: WorkspaceInterface[]): string[];
+    /**
+     * List local git tag names (short refs under `refs/tags/`).
+     */
+    protected listLocalTags(): Promise<Set<string>>;
+    /**
+     * Create local git tags for private packages after `changeset publish`.
+     *
+     * Changesets skips npm publish and tagging for `private: true` packages.
+     * Release still needs those tags as changelog baselines, so create them here.
+     */
+    protected ensurePrivateReleaseTags(workspaces: WorkspaceInterface[]): Promise<void>;
     /**
      * Push release tags from synced workspaces' `tagName` fields.
      *
-     * `changeset publish` only creates tags locally. After {@link syncWorkspaces},
-     * each publishable workspace should already have `tagName` (e.g. `pkg@1.2.3`).
+     * After {@link syncWorkspaces} and {@link ensurePrivateReleaseTags}, push
+     * tags that exist as local refs. Missing public-package tags are skipped
+     * (changeset may have skipped publish); they are not invented here.
      */
     protected pushWorkspaceReleaseTags(workspaces: WorkspaceInterface[]): Promise<void>;
     protected syncWorkspaces(workspaces: WorkspaceInterface[]): void;
@@ -1444,6 +1496,10 @@ declare const releaseJson: {
         readonly branchName: "release/${repoName}-${releaseId}";
         readonly releaseTagName: "release-tag-${count}-patch-${releaseId}";
         readonly commitMessage: "chore(release): ${spaces}";
+        /** GitHub release title template (createRelease mode) */
+        readonly releaseName: "${name}@${version}";
+        /** Path prefixes skipped when creating GitHub releases */
+        readonly ignoreReleasePaths: readonly string[];
         readonly label: {
             readonly name: "CI-Release";
             readonly color: "1A7F37";

package/dist/index.js

@@ -27,6 +27,10 @@ var releaseJson = {
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
+    /** GitHub release title template (createRelease mode) */
+    releaseName: "${name}@${version}",
+    /** Path prefixes skipped when creating GitHub releases */
+    ignoreReleasePaths: [],
     label: {
       name: "CI-Release",
       color: "1A7F37",
@@ -548,6 +552,9 @@ function workspaceVersionSummary(workspace) {
 function shouldProcessWorkspace(workspace, ignoreNonUpdatedPackages) {
   return !(ignoreNonUpdatedPackages && workspace.dependencyRelease);
 }
+function isPrivateWorkspace(workspace) {
+  return workspace.packageJson?.private === true;
+}
 function readJson(path) {
   const packageJsonContent = readFileSync(path, "utf-8");
   return JSON.parse(packageJsonContent);
@@ -1689,9 +1696,18 @@ ${workspaces?.map((workspace) => workspace.toString()).join("\n")}`
       this.logDryRun("Would run: changeset publish, publish packages and tags");
       const preview = this.mergeWorkspaces(workspaces);
       this.context.setWorkspaces(preview);
-      const previewTags = preview.filter(
-        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && workspace.tagName
+      const previewTags = this.collectPushableReleaseTags(preview);
+      const privateTags = preview.filter(
+        (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
       ).map((workspace) => workspace.tagName);
+      if (privateTags.length > 0) {
+        this.logDryRun(
+          `Would create local tag(s) for private package(s):
+${[
+            ...new Set(privateTags)
+          ].map((tag) => `  ${tag}`).join("\n")}`
+        );
+      }
       this.logDryRun(
         previewTags.length === 0 ? "Would push release tag(s) from workspace.tagName: none" : `Would push release tag(s) from workspace.tagName:
 ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
@@ -1705,37 +1721,106 @@ ${previewTags.map((tag) => `  ${tag}`).join("\n")}`
     if (workspaces.length > 0) {
       this.syncWorkspaces(workspaces);
     }
+    const syncedWorkspaces = this.context.workspaces ?? workspaces;
+    await this.step({
+      label: "Create Private Package Tags",
+      task: () => this.ensurePrivateReleaseTags(syncedWorkspaces)
+    });
     await this.step({
       label: "Push Release Tags",
-      task: () => this.pushWorkspaceReleaseTags(this.context.workspaces ?? workspaces)
+      task: () => this.pushWorkspaceReleaseTags(syncedWorkspaces)
     });
   }
   /**
-   * Push release tags from synced workspaces' `tagName` fields.
+   * Collect tag names that should be pushed after `changeset publish`.
    *
-   * `changeset publish` only creates tags locally. After {@link syncWorkspaces},
-   * each publishable workspace should already have `tagName` (e.g. `pkg@1.2.3`).
+   * Includes public packages (tagged by changesets) and private packages
+   * (tagged by {@link ensurePrivateReleaseTags}). Skips dependency-release
+   * workspaces.
    */
-  async pushWorkspaceReleaseTags(workspaces) {
+  collectPushableReleaseTags(workspaces) {
     const tags = workspaces.filter(
       (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && !!workspace.tagName
     ).map((workspace) => workspace.tagName);
-    const uniqueTags = [...new Set(tags)];
+    return [...new Set(tags)];
+  }
+  /**
+   * List local git tag names (short refs under `refs/tags/`).
+   */
+  async listLocalTags() {
+    const output = await this.shell.exec(
+      'git for-each-ref --format="%(refname:short)" refs/tags/',
+      { dryRun: false, silent: true }
+    );
+    const tags = output.split("\n").map((line) => line.trim()).filter(Boolean);
+    return new Set(tags);
+  }
+  /**
+   * Create local git tags for private packages after `changeset publish`.
+   *
+   * Changesets skips npm publish and tagging for `private: true` packages.
+   * Release still needs those tags as changelog baselines, so create them here.
+   */
+  async ensurePrivateReleaseTags(workspaces) {
+    const privateWorkspaces = workspaces.filter(
+      (workspace) => this.shouldProcessWorkspace(workspace) && !workspace.dependencyRelease && isPrivateWorkspace(workspace) && !!workspace.tagName
+    );
+    if (privateWorkspaces.length === 0) {
+      return;
+    }
+    const localTags = await this.listLocalTags();
+    for (const workspace of privateWorkspaces) {
+      const tagName = workspace.tagName;
+      if (localTags.has(tagName)) {
+        this.logger.debug(`Private package tag already exists: ${tagName}`);
+        continue;
+      }
+      this.logger.info(
+        `Create local release tag for private package: ${tagName}`
+      );
+      await this.shell.exec(["git", "tag", tagName]);
+      localTags.add(tagName);
+    }
+  }
+  /**
+   * Push release tags from synced workspaces' `tagName` fields.
+   *
+   * After {@link syncWorkspaces} and {@link ensurePrivateReleaseTags}, push
+   * tags that exist as local refs. Missing public-package tags are skipped
+   * (changeset may have skipped publish); they are not invented here.
+   */
+  async pushWorkspaceReleaseTags(workspaces) {
+    const uniqueTags = this.collectPushableReleaseTags(workspaces);
     if (uniqueTags.length === 0) {
       this.logger.warn(
         "No workspace.tagName found after publish sync; skip tag push"
       );
       return;
     }
+    const localTags = await this.listLocalTags();
+    const existingTags = uniqueTags.filter((tag) => localTags.has(tag));
+    const missingTags = uniqueTags.filter((tag) => !localTags.has(tag));
+    if (missingTags.length > 0) {
+      this.logger.warn(
+        `Skip push for missing local tag(s):
+${missingTags.map((tag) => `  ${tag}`).join("\n")}`
+      );
+    }
+    if (existingTags.length === 0) {
+      this.logger.warn(
+        "No local release tags found to push after publish; skip tag push"
+      );
+      return;
+    }
     this.logger.info(
-      `Pushing ${uniqueTags.length} release tag(s) to origin:
-${uniqueTags.map((tag) => `  ${tag}`).join("\n")}`
+      `Pushing ${existingTags.length} release tag(s) to origin:
+${existingTags.map((tag) => `  ${tag}`).join("\n")}`
     );
     await this.shell.exec([
       "git",
       "push",
       "origin",
-      ...uniqueTags.map((tag) => `"refs/tags/${tag}"`)
+      ...existingTags.map((tag) => `"refs/tags/${tag}"`)
     ]);
   }
   syncWorkspaces(workspaces) {
@@ -2620,7 +2705,7 @@ var GithubManager = class {
    */
   getOctokitReleaseOptions(options) {
     const {
-      releaseName,
+      releaseName = releaseJson.github.releaseName,
       draft = false,
       preRelease = false,
       autoGenerate = false,
@@ -2629,7 +2714,7 @@ var GithubManager = class {
       discussionCategoryName = void 0
     } = this.context.getParameters("github");
     const name = releaseName;
-    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes));
+    const body = autoGenerate ? "" : this.truncateBody(String(releaseNotes ?? ""));
     return {
       name,
       make_latest: makeLatest.toString(),
@@ -3393,6 +3478,7 @@ var ReleaseFormatter = class {
 var Github = class extends GitBase {
   releaseFormatter;
   githubManager;
+  pather = new Pather();
   constructor(context, props = {}) {
     super(context, "github", props);
     this.releaseFormatter = new ReleaseFormatter(
@@ -3404,6 +3490,9 @@ var Github = class extends GitBase {
   get mode() {
     return this.config.mode || releaseJson.github.mode;
   }
+  get ignoreReleasePaths() {
+    return this.config.ignoreReleasePaths ?? [...releaseJson.github.ignoreReleasePaths];
+  }
   async onBefore() {
     await super.onBefore();
     await this.githubManager.validateToken();
@@ -3429,6 +3518,9 @@ var Github = class extends GitBase {
           if (workspace.dependencyRelease) {
             return workspace;
           }
+          if (this.mode === "createRelease" && this.isIgnoredReleasePath(workspace)) {
+            return workspace;
+          }
           return githubChangelog.enrichWorkspaceChangelog(workspace);
         })
       )
@@ -3437,6 +3529,13 @@ var Github = class extends GitBase {
   }
   async onSuccess() {
     const workspaces = this.context.requireWorkspaces();
+    if (this.mode === "createRelease") {
+      await this.step({
+        label: "Create GitHub Releases",
+        task: () => this.createGithubReleases(workspaces)
+      });
+      return;
+    }
     const releaseBranchResult = await this.step({
       label: "Create Release Branch",
       task: () => this.createReleaseBranch(workspaces)
@@ -3453,6 +3552,63 @@ var Github = class extends GitBase {
     }
     await this.handleReleasePullRequest(workspaces, releaseBranchResult);
   }
+  /**
+   * Whether this workspace path is under an ignoreReleasePaths entry.
+   */
+  isIgnoredReleasePath(workspace) {
+    const ignorePaths = this.ignoreReleasePaths;
+    if (ignorePaths.length === 0) {
+      return false;
+    }
+    return ignorePaths.some(
+      (ignorePath) => this.pather.isSubPath(workspace.path, ignorePath)
+    );
+  }
+  /**
+   * Workspaces that should receive a GitHub Release in createRelease mode.
+   *
+   * Requires `tagName`. Skips dependency-release packages and paths matched
+   * by {@link GithubProps.ignoreReleasePaths}. Private packages are included
+   * when they have a tag.
+   */
+  getReleaseWorkspaces(workspaces) {
+    return workspaces.filter((workspace) => {
+      if (!workspace.tagName) {
+        return false;
+      }
+      if (workspace.dependencyRelease) {
+        return false;
+      }
+      if (this.isIgnoredReleasePath(workspace)) {
+        this.logger.info(
+          `Skip GitHub Release for ignored path: ${workspace.path} (${workspace.tagName})`
+        );
+        return false;
+      }
+      return true;
+    });
+  }
+  /**
+   * Create a GitHub Release for each eligible workspace.
+   *
+   * Release notes use the enriched workspace changelog from `onExec`.
+   */
+  async createGithubReleases(workspaces) {
+    const releaseWorkspaces = this.getReleaseWorkspaces(workspaces);
+    if (releaseWorkspaces.length === 0) {
+      this.logger.warn("No workspaces eligible for GitHub Release creation");
+      return;
+    }
+    this.logger.info(
+      `Creating GitHub Releases (${releaseWorkspaces.length}):
+${releaseWorkspaces.map((w) => `  ${w.tagName}`).join("\n")}`
+    );
+    await Promise.all(
+      releaseWorkspaces.map(
+        (workspace) => this.githubManager.createRelease(workspace)
+      )
+    );
+  }
   /**
    * Create the release PR and optionally auto-merge it.
    *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qlover/fe-release",
   "description": "A tool for releasing front-end projects, supporting multiple release modes and configurations, simplifying the release process and improving efficiency.",
-  "version": "5.0.5",
+  "version": "5.1.0",
   "type": "module",
   "private": false,
   "homepage": "https://github.com/qlover/fe-base/tree/master/packages/fe-release",
@@ -60,7 +60,7 @@
     "p-limit": "^6.2.0",
     "semver": "^7.5.4",
     "@qlover/env-loader": "1.0.2",
-    "@qlover/fe-corekit": "3.3.0",
+    "@qlover/fe-corekit": "3.4.4",
     "@qlover/logger": "1.2.1",
     "@qlover/scripts-context": "2.3.3"
   },