@releasekit/release 0.8.1 → 0.10.0

package/README.md

@@ -220,9 +220,9 @@ The `ci` section controls automation behavior:
       "stable": "release:stable",
       "prerelease": "release:prerelease",
       "skip": "release:skip",
-      "major": "release:major",
-      "minor": "release:minor",
-      "patch": "release:patch"
+      "major": "bump:major",
+      "minor": "bump:minor",
+      "patch": "bump:patch"
     },
 
     // Map PR labels to package filters for scoped releases
@@ -237,11 +237,11 @@ The `ci` section controls automation behavior:
 
 #### Release Trigger
 
-**`label`** (default) — A PR label (`release:patch`, `release:minor`, or `release:major`) is required to trigger a release. The label determines the bump type. PRs without a release label will not trigger a release when merged.
+**`label`** (default) — A PR label (`bump:patch`, `bump:minor`, or `bump:major`) is required to trigger a release. The label determines the bump type. PRs without a release label will not trigger a release when merged.
 
-**`commit`** — Conventional commits drive the bump type automatically. Every merge can trigger a release. Use the `release:skip` label to prevent a release, or `release:major` to override the commit-derived bump to major.
+**`commit`** — Conventional commits drive the bump type automatically. Every merge can trigger a release. Use the `release:skip` label to prevent a release, or `bump:major` to override the commit-derived bump to major.
 
-Both modes support `release:stable` and `release:prerelease` as modifiers.
+Both modes support `release:stable` and `release:prerelease` as channel modifiers. `release:stable` alone promotes a prerelease to stable without requiring a bump label. `release:prerelease` must be combined with a `bump:*` label — alone, it does not trigger a release.
 
 #### Release Strategy
 
@@ -278,7 +278,7 @@ When a PR has a matching scope label, only packages matching the pattern are inc
 | `defaultScope` | Fallback scope to use when no scope label is found (must reference a key in `scopeLabels`) |
 
 **Usage:**
-- `scope:shared` + `release:minor` → Release only `@myorg/shared-*` packages with minor bump
+- `scope:shared` + `bump:minor` → Release only `@myorg/shared-*` packages with minor bump
 - `scope:shared` + `scope:ui` → Release both matching scope groups
 - `scope:shared` (no release label) → Release only shared packages, bump determined by conventional commits
 - No scope label but `defaultScope` configured → Use default scope pattern
@@ -288,7 +288,7 @@ Multiple scope labels are combined with OR logic. Without a `release:*` label, c
 **Label conflicts:**
 
 In label trigger mode, conflicting labels will block the release and post a comment explaining the issue:
-- Multiple bump labels (`release:major` + `release:minor` + `release:patch`) → blocked
+- Multiple bump labels (`bump:major` + `bump:minor` + `bump:patch`) → blocked
 - Conflicting release type (`release:stable` + `release:prerelease`) → blocked (both modes)
 
 **How it works:**

package/dist/cli.js

@@ -14508,7 +14508,7 @@ var init_baseError_DQHIJACF = __esm({
   }
 });
 
-// ../version/dist/chunk-GHCENMVA.js
+// ../version/dist/chunk-5UIOLBFW.js
 import * as fs9 from "fs";
 import * as path12 from "path";
 import * as TOML2 from "smol-toml";
@@ -15148,6 +15148,10 @@ function bumpVersion(currentVersion, bumpType, prereleaseIdentifier) {
     if (!parsed) {
       return import_semver5.default.inc(currentVersion, bumpType) || "";
     }
+    if (prereleaseIdentifier) {
+      log4(`Incrementing prerelease for ${currentVersion} using 'prerelease'`, "debug");
+      return import_semver5.default.inc(currentVersion, "prerelease", prereleaseIdentifier) || "";
+    }
     if (bumpType === "major" && parsed.minor === 0 && parsed.patch === 0 || bumpType === "minor" && parsed.patch === 0 || bumpType === "patch") {
       log4(`Cleaning prerelease identifier from ${currentVersion} for ${bumpType} bump`, "debug");
       return `${parsed.major}.${parsed.minor}.${parsed.patch}`;
@@ -16111,7 +16115,7 @@ function createAsyncStrategy(config) {
       let packagesToProcess = packages.packages;
       if (targets.length > 0) {
         const beforeCount = packagesToProcess.length;
-        packagesToProcess = packagesToProcess.filter((pkg) => targets.includes(pkg.packageJson.name));
+        packagesToProcess = packagesToProcess.filter((pkg) => shouldMatchPackageTargets(pkg.packageJson.name, targets));
         log4(
           `Runtime targets filter: ${beforeCount} \u2192 ${packagesToProcess.length} packages (${targets.join(", ")})`,
           "info"
@@ -16297,8 +16301,8 @@ function createVersionCommand() {
   });
 }
 var import_semver3, import_semver4, import_semver5, ConfigError2, MAX_JSONC_LENGTH2, GitConfigSchema2, MonorepoConfigSchema2, BranchPatternSchema2, VersionCargoConfigSchema2, VersionConfigSchema2, NpmConfigSchema2, CargoPublishConfigSchema2, PublishGitConfigSchema2, GitHubReleaseConfigSchema2, VerifyRegistryConfigSchema2, VerifyConfigSchema2, PublishConfigSchema2, TemplateConfigSchema2, LocationModeSchema2, ChangelogConfigSchema2, LLMOptionsSchema2, LLMRetryConfigSchema2, LLMTasksConfigSchema2, LLMCategorySchema2, ScopeRulesSchema2, ScopeConfigSchema2, LLMPromptOverridesSchema2, LLMPromptsConfigSchema2, LLMConfigSchema2, ReleaseNotesConfigSchema2, NotesInputConfigSchema2, NotesConfigSchema2, CILabelsConfigSchema2, CIConfigSchema2, ReleaseCIConfigSchema2, ReleaseConfigSchema2, ReleaseKitConfigSchema2, MAX_INPUT_LENGTH2, SOLE_REFERENCE_PATTERN2, AUTH_DIR2, AUTH_FILE2, CONFIG_FILE2, VersionError, VersionErrorCode, _jsonOutputMode, _pendingWrites, _jsonData, STANDARD_BUMP_TYPES, VersionMismatchError, CONVENTIONAL_COMMIT_REGEX, BREAKING_CHANGE_REGEX, PackageProcessor, GitError, VersionEngine;
-var init_chunk_GHCENMVA = __esm({
-  "../version/dist/chunk-GHCENMVA.js"() {
+var init_chunk_5UIOLBFW = __esm({
+  "../version/dist/chunk-5UIOLBFW.js"() {
     "use strict";
     init_chunk_Q3FHZORY();
     init_chunk_LMPZV35Z();
@@ -16560,9 +16564,9 @@ var init_chunk_GHCENMVA = __esm({
       stable: z3.string().default("release:stable"),
       prerelease: z3.string().default("release:prerelease"),
       skip: z3.string().default("release:skip"),
-      major: z3.string().default("release:major"),
-      minor: z3.string().default("release:minor"),
-      patch: z3.string().default("release:patch")
+      major: z3.string().default("bump:major"),
+      minor: z3.string().default("bump:minor"),
+      patch: z3.string().default("bump:patch")
     });
     CIConfigSchema2 = z3.object({
       releaseStrategy: z3.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -16581,9 +16585,9 @@ var init_chunk_GHCENMVA = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -17050,7 +17054,7 @@ __export(dist_exports3, {
 var init_dist13 = __esm({
   "../version/dist/index.js"() {
     "use strict";
-    init_chunk_GHCENMVA();
+    init_chunk_5UIOLBFW();
     init_chunk_Q3FHZORY();
     init_chunk_LMPZV35Z();
   }
@@ -41929,7 +41933,7 @@ var init_aggregator_IUQUAVJC = __esm({
   }
 });
 
-// ../notes/dist/chunk-5B2RYLOK.js
+// ../notes/dist/chunk-R6IWJNYC.js
 import * as TOML3 from "smol-toml";
 import * as fs33 from "fs";
 import * as path33 from "path";
@@ -43261,8 +43265,8 @@ function handleError(err) {
   process.exit(EXIT_CODES2.GENERAL_ERROR);
 }
 var import_handlebars, ConfigError3, MAX_JSONC_LENGTH3, GitConfigSchema3, MonorepoConfigSchema3, BranchPatternSchema3, VersionCargoConfigSchema3, VersionConfigSchema3, NpmConfigSchema3, CargoPublishConfigSchema3, PublishGitConfigSchema3, GitHubReleaseConfigSchema3, VerifyRegistryConfigSchema3, VerifyConfigSchema3, PublishConfigSchema3, TemplateConfigSchema3, LocationModeSchema3, ChangelogConfigSchema3, LLMOptionsSchema3, LLMRetryConfigSchema3, LLMTasksConfigSchema3, LLMCategorySchema3, ScopeRulesSchema3, ScopeConfigSchema3, LLMPromptOverridesSchema3, LLMPromptsConfigSchema3, LLMConfigSchema3, ReleaseNotesConfigSchema3, NotesInputConfigSchema3, NotesConfigSchema3, CILabelsConfigSchema3, CIConfigSchema3, ReleaseCIConfigSchema3, ReleaseConfigSchema3, ReleaseKitConfigSchema3, MAX_INPUT_LENGTH3, SOLE_REFERENCE_PATTERN3, AUTH_DIR3, AUTH_FILE3, CONFIG_FILE3, NotesError, InputParseError, TemplateError, LLMError, GitHubError, ConfigError22, LLM_DEFAULTS, BaseLLMProvider, AnthropicProvider, OllamaProvider, OpenAIProvider, OpenAICompatibleProvider, DEFAULT_CATEGORIZE_PROMPT, DEFAULT_ENHANCE_PROMPT, DEFAULT_RELEASE_NOTES_PROMPT, DEFAULT_SUMMARIZE_PROMPT;
-var init_chunk_5B2RYLOK = __esm({
-  "../notes/dist/chunk-5B2RYLOK.js"() {
+var init_chunk_R6IWJNYC = __esm({
+  "../notes/dist/chunk-R6IWJNYC.js"() {
     "use strict";
     init_chunk_7TJSPQPW();
     init_sdk();
@@ -43520,9 +43524,9 @@ var init_chunk_5B2RYLOK = __esm({
       stable: z4.string().default("release:stable"),
       prerelease: z4.string().default("release:prerelease"),
       skip: z4.string().default("release:skip"),
-      major: z4.string().default("release:major"),
-      minor: z4.string().default("release:minor"),
-      patch: z4.string().default("release:patch")
+      major: z4.string().default("bump:major"),
+      minor: z4.string().default("bump:minor"),
+      patch: z4.string().default("bump:patch")
     });
     CIConfigSchema3 = z4.object({
       releaseStrategy: z4.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -43541,9 +43545,9 @@ var init_chunk_5B2RYLOK = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -43937,13 +43941,13 @@ function writeJson(outputPath, contexts, dryRun) {
 var init_dist14 = __esm({
   "../notes/dist/index.js"() {
     "use strict";
-    init_chunk_5B2RYLOK();
+    init_chunk_R6IWJNYC();
     init_chunk_F7MUVHZ2();
     init_chunk_7TJSPQPW();
   }
 });
 
-// ../publish/dist/chunk-UARK5H2F.js
+// ../publish/dist/chunk-ZTUEJDI7.js
 import chalk5 from "chalk";
 import * as fs25 from "fs";
 import * as TOML4 from "smol-toml";
@@ -45480,8 +45484,8 @@ function createPublishCommand() {
   });
 }
 var import_semver6, LOG_LEVELS4, PREFIXES4, COLORS4, currentLevel4, quietMode4, ReleaseKitError4, EXIT_CODES3, ConfigError4, MAX_JSONC_LENGTH4, GitConfigSchema4, MonorepoConfigSchema4, BranchPatternSchema4, VersionCargoConfigSchema4, VersionConfigSchema4, NpmConfigSchema4, CargoPublishConfigSchema4, PublishGitConfigSchema4, GitHubReleaseConfigSchema4, VerifyRegistryConfigSchema4, VerifyConfigSchema4, PublishConfigSchema4, TemplateConfigSchema4, LocationModeSchema4, ChangelogConfigSchema4, LLMOptionsSchema4, LLMRetryConfigSchema4, LLMTasksConfigSchema4, LLMCategorySchema4, ScopeRulesSchema4, ScopeConfigSchema4, LLMPromptOverridesSchema4, LLMPromptsConfigSchema4, LLMConfigSchema4, ReleaseNotesConfigSchema4, NotesInputConfigSchema4, NotesConfigSchema4, CILabelsConfigSchema4, CIConfigSchema4, ReleaseCIConfigSchema4, ReleaseConfigSchema4, ReleaseKitConfigSchema4, MAX_INPUT_LENGTH4, SOLE_REFERENCE_PATTERN4, AUTH_DIR4, AUTH_FILE4, CONFIG_FILE4, BasePublishError, PublishError, PipelineError, PublishErrorCode, VersionChangelogEntrySchema, VersionPackageChangelogSchema, VersionPackageUpdateSchema, VersionOutputSchema;
-var init_chunk_UARK5H2F = __esm({
-  "../publish/dist/chunk-UARK5H2F.js"() {
+var init_chunk_ZTUEJDI7 = __esm({
+  "../publish/dist/chunk-ZTUEJDI7.js"() {
     "use strict";
     import_semver6 = __toESM(require_semver2(), 1);
     LOG_LEVELS4 = {
@@ -45786,9 +45790,9 @@ var init_chunk_UARK5H2F = __esm({
       stable: z5.string().default("release:stable"),
       prerelease: z5.string().default("release:prerelease"),
       skip: z5.string().default("release:skip"),
-      major: z5.string().default("release:major"),
-      minor: z5.string().default("release:minor"),
-      patch: z5.string().default("release:patch")
+      major: z5.string().default("bump:major"),
+      minor: z5.string().default("bump:minor"),
+      patch: z5.string().default("bump:patch")
     });
     CIConfigSchema4 = z5.object({
       releaseStrategy: z5.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -45807,9 +45811,9 @@ var init_chunk_UARK5H2F = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -45954,7 +45958,7 @@ __export(dist_exports5, {
 var init_dist15 = __esm({
   "../publish/dist/index.js"() {
     "use strict";
-    init_chunk_UARK5H2F();
+    init_chunk_ZTUEJDI7();
   }
 });
 
@@ -46336,9 +46340,9 @@ var CILabelsConfigSchema = z.object({
   stable: z.string().default("release:stable"),
   prerelease: z.string().default("release:prerelease"),
   skip: z.string().default("release:skip"),
-  major: z.string().default("release:major"),
-  minor: z.string().default("release:minor"),
-  patch: z.string().default("release:patch")
+  major: z.string().default("bump:major"),
+  minor: z.string().default("bump:minor"),
+  patch: z.string().default("bump:patch")
 });
 var CIConfigSchema = z.object({
   releaseStrategy: z.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -46357,9 +46361,9 @@ var CIConfigSchema = z.object({
     stable: "release:stable",
     prerelease: "release:prerelease",
     skip: "release:skip",
-    major: "release:major",
-    minor: "release:minor",
-    patch: "release:patch"
+    major: "bump:major",
+    minor: "bump:minor",
+    patch: "bump:patch"
   }),
   /**
    * Map of scope labels to package patterns.
@@ -46479,9 +46483,9 @@ var DEFAULT_LABELS = {
   stable: "release:stable",
   prerelease: "release:prerelease",
   skip: "release:skip",
-  major: "release:major",
-  minor: "release:minor",
-  patch: "release:patch"
+  major: "bump:major",
+  minor: "bump:minor",
+  patch: "bump:patch"
 };
 function detectLabelConflicts(prLabels, labels = DEFAULT_LABELS) {
   const bumpLabelsPresent = [
@@ -46646,7 +46650,7 @@ function getLabelBanner(labelContext) {
   if (labelContext.trigger === "label") {
     if (labelContext.bumpConflict) {
       const labels = labelContext.labels;
-      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a release label (e.g., `release:patch`, `release:minor`, `release:major`)";
+      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a bump label (e.g., `bump:patch`, `bump:minor`, `bump:major`)";
       lines.push(
         "> **Error:** Conflicting bump labels detected.",
         `> **Note:** Please use only one release label at a time. Use ${labelExamples}.`,
@@ -46656,12 +46660,28 @@ function getLabelBanner(labelContext) {
     }
     if (labelContext.noBumpLabel) {
       const labels = labelContext.labels;
-      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a release label (e.g., `release:patch`, `release:minor`, `release:major`)";
-      lines.push("> No release label detected.", `> **Note:** Add ${labelExamples} to trigger a release.`, "");
+      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a bump label (e.g., `bump:patch`, `bump:minor`, `bump:major`)";
+      lines.push("> No bump label detected.", `> **Note:** Add ${labelExamples} to trigger a release.`, "");
       return lines;
     }
     if (labelContext.bumpLabel) {
-      lines.push(`> This PR is labeled for a **${labelContext.bumpLabel}** release.`, "");
+      const parts = [labelContext.bumpLabel];
+      if (labelContext.prerelease) {
+        parts.push("prerelease");
+      }
+      if (labelContext.stable) {
+        parts.push("stable");
+      }
+      const labelText = parts.join(" ");
+      lines.push(`> This PR is labeled for a **${labelText}** release.`, "");
+      return lines;
+    }
+    if (labelContext.stable) {
+      lines.push("> This PR is labeled for a **stable** release (graduation from prerelease).", "");
+      return lines;
+    }
+    if (labelContext.prerelease) {
+      lines.push("> This PR is labeled for a **prerelease** release (bump from conventional commits).", "");
       return lines;
     }
   }
@@ -46867,16 +46887,22 @@ async function applyScopeLabelsFromPR(ciConfig, options) {
   const allLabels = [];
   const perPRLabels = /* @__PURE__ */ new Map();
   for (const prNumber of prNumbers) {
-    const labels = await fetchPRLabels(octokit, githubContext.owner, githubContext.repo, prNumber);
-    allLabels.push(...labels);
-    perPRLabels.set(prNumber, labels);
+    const labels2 = await fetchPRLabels(octokit, githubContext.owner, githubContext.repo, prNumber);
+    allLabels.push(...labels2);
+    perPRLabels.set(prNumber, labels2);
   }
-  for (const [prNumber, labels] of perPRLabels) {
-    const conflict = detectLabelConflicts(labels, ciConfig?.labels ?? DEFAULT_LABELS);
+  const labels = ciConfig?.labels ?? DEFAULT_LABELS;
+  for (const [prNumber, prLabels] of perPRLabels) {
+    const conflict = detectLabelConflicts(prLabels, labels);
+    if ((ciConfig?.releaseTrigger ?? "label") === "commit" && prLabels.includes(labels.skip)) {
+      info(`PR #${prNumber} has "${labels.skip}" label \u2014 skipping release`);
+      return { target: options.target, scopeLabels: [], labels: [], skipped: true };
+    }
+    if (prLabels.includes(labels.skip)) {
+      warn(`PR #${prNumber} has "${labels.skip}" label \u2014 this has no effect in label trigger mode`);
+    }
     if (conflict.prereleaseConflict) {
-      warn(
-        `PR #${prNumber} has conflicting labels "${ciConfig?.labels?.stable ?? "release:stable"}" and "${ciConfig?.labels?.prerelease ?? "release:prerelease"}" \u2014 release blocked`
-      );
+      warn(`PR #${prNumber} has conflicting labels "${labels.stable}" and "${labels.prerelease}" \u2014 release blocked`);
       return { target: options.target, scopeLabels: [], labels: [], blocked: true };
     }
     if (conflict.bumpConflict && (ciConfig?.releaseTrigger ?? "label") === "label") {
@@ -46928,19 +46954,14 @@ async function runRelease(inputOptions) {
   }
   const releaseConfig = releaseKitConfig.release;
   const ciConfig = loadCIConfig({ cwd: options.projectDir, configPath: options.config });
-  if (!options.dryRun) {
+  if (!options.dryRun || ciConfig?.scopeLabels) {
     const scopeResult = await applyScopeLabelsFromPR(ciConfig, options);
     if (scopeResult.blocked) {
       info("Release blocked due to conflicting PR labels");
       return null;
     }
-    if (scopeResult.target !== options.target) {
-      options.target = scopeResult.target;
-    }
-  } else if (ciConfig?.scopeLabels) {
-    const scopeResult = await applyScopeLabelsFromPR(ciConfig, options);
-    if (scopeResult.blocked) {
-      info("Release blocked due to conflicting PR labels");
+    if (scopeResult.skipped) {
+      info("Release skipped due to release:skip label");
       return null;
     }
     if (scopeResult.target !== options.target) {
@@ -47095,7 +47116,7 @@ async function runPreview(options) {
   const { options: effectiveOptions, labelContext } = await applyLabelOverrides(options, ciConfig, context, octokit);
   const strategy = ciConfig?.releaseStrategy ?? "direct";
   let result = null;
-  if (!labelContext.noBumpLabel) {
+  if (!labelContext.skip && !labelContext.noBumpLabel) {
     const releaseConfig = loadConfig({ cwd: effectiveOptions.projectDir, configPath: effectiveOptions.config });
     const prereleaseFlag = resolvePrerelease(
       effectiveOptions,
@@ -47236,25 +47257,26 @@ async function applyLabelOverrides(options, ciConfig, context, existingOctokit)
       labelContext.bumpLabel = "patch";
       result.bump = "patch";
     } else if (matchedScopePatterns.length === 0) {
-      const hasStableOrPrerelease = conflict.hasStable || conflict.hasPrerelease;
-      if (!hasStableOrPrerelease) {
+      if (!conflict.hasStable) {
         labelContext.noBumpLabel = true;
       }
     }
+    if (prLabels.includes(labels.skip)) {
+      warn(
+        `PR label "${labels.skip}" has no effect in label trigger mode \u2014 skipping is controlled by not adding bump labels`
+      );
+    }
   }
   if (!options.stable && options.prerelease === void 0) {
     if (conflict.hasStable && conflict.hasPrerelease) {
     } else if (conflict.hasStable) {
       info(`PR label "${labels.stable}" detected \u2014 using stable release preview`);
       result.stable = true;
+      labelContext.stable = true;
     } else if (conflict.hasPrerelease) {
       info(`PR label "${labels.prerelease}" detected \u2014 using prerelease preview`);
       result.prerelease = true;
-      if (trigger === "label" && !result.bump) {
-        info("No bump label found \u2014 defaulting to patch bump for prerelease release");
-        result.bump = "patch";
-        labelContext.bumpLabel = "patch";
-      }
+      labelContext.prerelease = true;
     }
   }
   return { options: result, labelContext: { ...labelContext, labels } };

package/dist/dispatcher.js

@@ -24913,7 +24913,7 @@ var init_aggregator_IUQUAVJC = __esm({
   }
 });
 
-// ../notes/dist/chunk-5B2RYLOK.js
+// ../notes/dist/chunk-R6IWJNYC.js
 import * as TOML from "smol-toml";
 import * as fs32 from "fs";
 import * as path32 from "path";
@@ -26245,8 +26245,8 @@ function handleError(err) {
   process.exit(EXIT_CODES2.GENERAL_ERROR);
 }
 var import_handlebars, ConfigError, MAX_JSONC_LENGTH, GitConfigSchema, MonorepoConfigSchema, BranchPatternSchema, VersionCargoConfigSchema, VersionConfigSchema, NpmConfigSchema, CargoPublishConfigSchema, PublishGitConfigSchema, GitHubReleaseConfigSchema, VerifyRegistryConfigSchema, VerifyConfigSchema, PublishConfigSchema, TemplateConfigSchema, LocationModeSchema, ChangelogConfigSchema, LLMOptionsSchema, LLMRetryConfigSchema, LLMTasksConfigSchema, LLMCategorySchema, ScopeRulesSchema, ScopeConfigSchema, LLMPromptOverridesSchema, LLMPromptsConfigSchema, LLMConfigSchema, ReleaseNotesConfigSchema, NotesInputConfigSchema, NotesConfigSchema, CILabelsConfigSchema, CIConfigSchema, ReleaseCIConfigSchema, ReleaseConfigSchema, ReleaseKitConfigSchema, MAX_INPUT_LENGTH, SOLE_REFERENCE_PATTERN, AUTH_DIR, AUTH_FILE, CONFIG_FILE, NotesError, InputParseError, TemplateError, LLMError, GitHubError, ConfigError2, LLM_DEFAULTS, BaseLLMProvider, AnthropicProvider, OllamaProvider, OpenAIProvider, OpenAICompatibleProvider, DEFAULT_CATEGORIZE_PROMPT, DEFAULT_ENHANCE_PROMPT, DEFAULT_RELEASE_NOTES_PROMPT, DEFAULT_SUMMARIZE_PROMPT;
-var init_chunk_5B2RYLOK = __esm({
-  "../notes/dist/chunk-5B2RYLOK.js"() {
+var init_chunk_R6IWJNYC = __esm({
+  "../notes/dist/chunk-R6IWJNYC.js"() {
     "use strict";
     init_chunk_7TJSPQPW();
     init_sdk();
@@ -26504,9 +26504,9 @@ var init_chunk_5B2RYLOK = __esm({
       stable: z.string().default("release:stable"),
       prerelease: z.string().default("release:prerelease"),
       skip: z.string().default("release:skip"),
-      major: z.string().default("release:major"),
-      minor: z.string().default("release:minor"),
-      patch: z.string().default("release:patch")
+      major: z.string().default("bump:major"),
+      minor: z.string().default("bump:minor"),
+      patch: z.string().default("bump:patch")
     });
     CIConfigSchema = z.object({
       releaseStrategy: z.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -26525,9 +26525,9 @@ var init_chunk_5B2RYLOK = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -26921,7 +26921,7 @@ function writeJson(outputPath, contexts, dryRun) {
 var init_dist = __esm({
   "../notes/dist/index.js"() {
     "use strict";
-    init_chunk_5B2RYLOK();
+    init_chunk_R6IWJNYC();
     init_chunk_F7MUVHZ2();
     init_chunk_7TJSPQPW();
   }
@@ -28857,7 +28857,7 @@ var require_semver2 = __commonJS({
   }
 });
 
-// ../publish/dist/chunk-UARK5H2F.js
+// ../publish/dist/chunk-ZTUEJDI7.js
 import chalk3 from "chalk";
 import * as fs23 from "fs";
 import * as TOML2 from "smol-toml";
@@ -30394,8 +30394,8 @@ function createPublishCommand() {
   });
 }
 var import_semver, LOG_LEVELS3, PREFIXES3, COLORS3, currentLevel3, quietMode3, ReleaseKitError3, EXIT_CODES3, ConfigError3, MAX_JSONC_LENGTH2, GitConfigSchema2, MonorepoConfigSchema2, BranchPatternSchema2, VersionCargoConfigSchema2, VersionConfigSchema2, NpmConfigSchema2, CargoPublishConfigSchema2, PublishGitConfigSchema2, GitHubReleaseConfigSchema2, VerifyRegistryConfigSchema2, VerifyConfigSchema2, PublishConfigSchema2, TemplateConfigSchema2, LocationModeSchema2, ChangelogConfigSchema2, LLMOptionsSchema2, LLMRetryConfigSchema2, LLMTasksConfigSchema2, LLMCategorySchema2, ScopeRulesSchema2, ScopeConfigSchema2, LLMPromptOverridesSchema2, LLMPromptsConfigSchema2, LLMConfigSchema2, ReleaseNotesConfigSchema2, NotesInputConfigSchema2, NotesConfigSchema2, CILabelsConfigSchema2, CIConfigSchema2, ReleaseCIConfigSchema2, ReleaseConfigSchema2, ReleaseKitConfigSchema2, MAX_INPUT_LENGTH2, SOLE_REFERENCE_PATTERN2, AUTH_DIR2, AUTH_FILE2, CONFIG_FILE2, BasePublishError, PublishError, PipelineError, PublishErrorCode, VersionChangelogEntrySchema, VersionPackageChangelogSchema, VersionPackageUpdateSchema, VersionOutputSchema;
-var init_chunk_UARK5H2F = __esm({
-  "../publish/dist/chunk-UARK5H2F.js"() {
+var init_chunk_ZTUEJDI7 = __esm({
+  "../publish/dist/chunk-ZTUEJDI7.js"() {
     "use strict";
     import_semver = __toESM(require_semver2(), 1);
     LOG_LEVELS3 = {
@@ -30700,9 +30700,9 @@ var init_chunk_UARK5H2F = __esm({
       stable: z3.string().default("release:stable"),
       prerelease: z3.string().default("release:prerelease"),
       skip: z3.string().default("release:skip"),
-      major: z3.string().default("release:major"),
-      minor: z3.string().default("release:minor"),
-      patch: z3.string().default("release:patch")
+      major: z3.string().default("bump:major"),
+      minor: z3.string().default("bump:minor"),
+      patch: z3.string().default("bump:patch")
     });
     CIConfigSchema2 = z3.object({
       releaseStrategy: z3.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -30721,9 +30721,9 @@ var init_chunk_UARK5H2F = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -30868,7 +30868,7 @@ __export(dist_exports2, {
 var init_dist2 = __esm({
   "../publish/dist/index.js"() {
     "use strict";
-    init_chunk_UARK5H2F();
+    init_chunk_ZTUEJDI7();
   }
 });
 
@@ -43410,7 +43410,7 @@ var init_baseError_DQHIJACF = __esm({
   }
 });
 
-// ../version/dist/chunk-GHCENMVA.js
+// ../version/dist/chunk-5UIOLBFW.js
 import * as fs15 from "fs";
 import * as path17 from "path";
 import * as TOML3 from "smol-toml";
@@ -44050,6 +44050,10 @@ function bumpVersion(currentVersion, bumpType, prereleaseIdentifier) {
     if (!parsed) {
       return import_semver6.default.inc(currentVersion, bumpType) || "";
     }
+    if (prereleaseIdentifier) {
+      log6(`Incrementing prerelease for ${currentVersion} using 'prerelease'`, "debug");
+      return import_semver6.default.inc(currentVersion, "prerelease", prereleaseIdentifier) || "";
+    }
     if (bumpType === "major" && parsed.minor === 0 && parsed.patch === 0 || bumpType === "minor" && parsed.patch === 0 || bumpType === "patch") {
       log6(`Cleaning prerelease identifier from ${currentVersion} for ${bumpType} bump`, "debug");
       return `${parsed.major}.${parsed.minor}.${parsed.patch}`;
@@ -45013,7 +45017,7 @@ function createAsyncStrategy(config) {
       let packagesToProcess = packages.packages;
       if (targets.length > 0) {
         const beforeCount = packagesToProcess.length;
-        packagesToProcess = packagesToProcess.filter((pkg) => targets.includes(pkg.packageJson.name));
+        packagesToProcess = packagesToProcess.filter((pkg) => shouldMatchPackageTargets(pkg.packageJson.name, targets));
         log6(
           `Runtime targets filter: ${beforeCount} \u2192 ${packagesToProcess.length} packages (${targets.join(", ")})`,
           "info"
@@ -45199,8 +45203,8 @@ function createVersionCommand() {
   });
 }
 var import_semver4, import_semver5, import_semver6, ConfigError4, MAX_JSONC_LENGTH3, GitConfigSchema3, MonorepoConfigSchema3, BranchPatternSchema3, VersionCargoConfigSchema3, VersionConfigSchema3, NpmConfigSchema3, CargoPublishConfigSchema3, PublishGitConfigSchema3, GitHubReleaseConfigSchema3, VerifyRegistryConfigSchema3, VerifyConfigSchema3, PublishConfigSchema3, TemplateConfigSchema3, LocationModeSchema3, ChangelogConfigSchema3, LLMOptionsSchema3, LLMRetryConfigSchema3, LLMTasksConfigSchema3, LLMCategorySchema3, ScopeRulesSchema3, ScopeConfigSchema3, LLMPromptOverridesSchema3, LLMPromptsConfigSchema3, LLMConfigSchema3, ReleaseNotesConfigSchema3, NotesInputConfigSchema3, NotesConfigSchema3, CILabelsConfigSchema3, CIConfigSchema3, ReleaseCIConfigSchema3, ReleaseConfigSchema3, ReleaseKitConfigSchema3, MAX_INPUT_LENGTH3, SOLE_REFERENCE_PATTERN3, AUTH_DIR3, AUTH_FILE3, CONFIG_FILE3, VersionError, VersionErrorCode, _jsonOutputMode, _pendingWrites, _jsonData, STANDARD_BUMP_TYPES, VersionMismatchError, CONVENTIONAL_COMMIT_REGEX, BREAKING_CHANGE_REGEX, PackageProcessor, GitError, VersionEngine;
-var init_chunk_GHCENMVA = __esm({
-  "../version/dist/chunk-GHCENMVA.js"() {
+var init_chunk_5UIOLBFW = __esm({
+  "../version/dist/chunk-5UIOLBFW.js"() {
     "use strict";
     init_chunk_Q3FHZORY();
     init_chunk_LMPZV35Z();
@@ -45462,9 +45466,9 @@ var init_chunk_GHCENMVA = __esm({
       stable: z4.string().default("release:stable"),
       prerelease: z4.string().default("release:prerelease"),
       skip: z4.string().default("release:skip"),
-      major: z4.string().default("release:major"),
-      minor: z4.string().default("release:minor"),
-      patch: z4.string().default("release:patch")
+      major: z4.string().default("bump:major"),
+      minor: z4.string().default("bump:minor"),
+      patch: z4.string().default("bump:patch")
     });
     CIConfigSchema3 = z4.object({
       releaseStrategy: z4.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -45483,9 +45487,9 @@ var init_chunk_GHCENMVA = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -45952,7 +45956,7 @@ __export(dist_exports5, {
 var init_dist15 = __esm({
   "../version/dist/index.js"() {
     "use strict";
-    init_chunk_GHCENMVA();
+    init_chunk_5UIOLBFW();
     init_chunk_Q3FHZORY();
     init_chunk_LMPZV35Z();
   }
@@ -46388,9 +46392,9 @@ var CILabelsConfigSchema4 = z5.object({
   stable: z5.string().default("release:stable"),
   prerelease: z5.string().default("release:prerelease"),
   skip: z5.string().default("release:skip"),
-  major: z5.string().default("release:major"),
-  minor: z5.string().default("release:minor"),
-  patch: z5.string().default("release:patch")
+  major: z5.string().default("bump:major"),
+  minor: z5.string().default("bump:minor"),
+  patch: z5.string().default("bump:patch")
 });
 var CIConfigSchema4 = z5.object({
   releaseStrategy: z5.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -46409,9 +46413,9 @@ var CIConfigSchema4 = z5.object({
     stable: "release:stable",
     prerelease: "release:prerelease",
     skip: "release:skip",
-    major: "release:major",
-    minor: "release:minor",
-    patch: "release:patch"
+    major: "bump:major",
+    minor: "bump:minor",
+    patch: "bump:patch"
   }),
   /**
    * Map of scope labels to package patterns.
@@ -46531,9 +46535,9 @@ var DEFAULT_LABELS = {
   stable: "release:stable",
   prerelease: "release:prerelease",
   skip: "release:skip",
-  major: "release:major",
-  minor: "release:minor",
-  patch: "release:patch"
+  major: "bump:major",
+  minor: "bump:minor",
+  patch: "bump:patch"
 };
 function detectLabelConflicts(prLabels, labels = DEFAULT_LABELS) {
   const bumpLabelsPresent = [
@@ -46698,7 +46702,7 @@ function getLabelBanner(labelContext) {
   if (labelContext.trigger === "label") {
     if (labelContext.bumpConflict) {
       const labels = labelContext.labels;
-      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a release label (e.g., `release:patch`, `release:minor`, `release:major`)";
+      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a bump label (e.g., `bump:patch`, `bump:minor`, `bump:major`)";
       lines.push(
         "> **Error:** Conflicting bump labels detected.",
         `> **Note:** Please use only one release label at a time. Use ${labelExamples}.`,
@@ -46708,12 +46712,28 @@ function getLabelBanner(labelContext) {
     }
     if (labelContext.noBumpLabel) {
       const labels = labelContext.labels;
-      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a release label (e.g., `release:patch`, `release:minor`, `release:major`)";
-      lines.push("> No release label detected.", `> **Note:** Add ${labelExamples} to trigger a release.`, "");
+      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a bump label (e.g., `bump:patch`, `bump:minor`, `bump:major`)";
+      lines.push("> No bump label detected.", `> **Note:** Add ${labelExamples} to trigger a release.`, "");
       return lines;
     }
     if (labelContext.bumpLabel) {
-      lines.push(`> This PR is labeled for a **${labelContext.bumpLabel}** release.`, "");
+      const parts = [labelContext.bumpLabel];
+      if (labelContext.prerelease) {
+        parts.push("prerelease");
+      }
+      if (labelContext.stable) {
+        parts.push("stable");
+      }
+      const labelText = parts.join(" ");
+      lines.push(`> This PR is labeled for a **${labelText}** release.`, "");
+      return lines;
+    }
+    if (labelContext.stable) {
+      lines.push("> This PR is labeled for a **stable** release (graduation from prerelease).", "");
+      return lines;
+    }
+    if (labelContext.prerelease) {
+      lines.push("> This PR is labeled for a **prerelease** release (bump from conventional commits).", "");
       return lines;
     }
   }
@@ -46919,16 +46939,22 @@ async function applyScopeLabelsFromPR(ciConfig, options) {
   const allLabels = [];
   const perPRLabels = /* @__PURE__ */ new Map();
   for (const prNumber of prNumbers) {
-    const labels = await fetchPRLabels(octokit, githubContext.owner, githubContext.repo, prNumber);
-    allLabels.push(...labels);
-    perPRLabels.set(prNumber, labels);
+    const labels2 = await fetchPRLabels(octokit, githubContext.owner, githubContext.repo, prNumber);
+    allLabels.push(...labels2);
+    perPRLabels.set(prNumber, labels2);
   }
-  for (const [prNumber, labels] of perPRLabels) {
-    const conflict = detectLabelConflicts(labels, ciConfig?.labels ?? DEFAULT_LABELS);
+  const labels = ciConfig?.labels ?? DEFAULT_LABELS;
+  for (const [prNumber, prLabels] of perPRLabels) {
+    const conflict = detectLabelConflicts(prLabels, labels);
+    if ((ciConfig?.releaseTrigger ?? "label") === "commit" && prLabels.includes(labels.skip)) {
+      info(`PR #${prNumber} has "${labels.skip}" label \u2014 skipping release`);
+      return { target: options.target, scopeLabels: [], labels: [], skipped: true };
+    }
+    if (prLabels.includes(labels.skip)) {
+      warn(`PR #${prNumber} has "${labels.skip}" label \u2014 this has no effect in label trigger mode`);
+    }
     if (conflict.prereleaseConflict) {
-      warn(
-        `PR #${prNumber} has conflicting labels "${ciConfig?.labels?.stable ?? "release:stable"}" and "${ciConfig?.labels?.prerelease ?? "release:prerelease"}" \u2014 release blocked`
-      );
+      warn(`PR #${prNumber} has conflicting labels "${labels.stable}" and "${labels.prerelease}" \u2014 release blocked`);
       return { target: options.target, scopeLabels: [], labels: [], blocked: true };
     }
     if (conflict.bumpConflict && (ciConfig?.releaseTrigger ?? "label") === "label") {
@@ -46980,19 +47006,14 @@ async function runRelease(inputOptions) {
   }
   const releaseConfig = releaseKitConfig.release;
   const ciConfig = loadCIConfig({ cwd: options.projectDir, configPath: options.config });
-  if (!options.dryRun) {
+  if (!options.dryRun || ciConfig?.scopeLabels) {
     const scopeResult = await applyScopeLabelsFromPR(ciConfig, options);
     if (scopeResult.blocked) {
       info("Release blocked due to conflicting PR labels");
       return null;
     }
-    if (scopeResult.target !== options.target) {
-      options.target = scopeResult.target;
-    }
-  } else if (ciConfig?.scopeLabels) {
-    const scopeResult = await applyScopeLabelsFromPR(ciConfig, options);
-    if (scopeResult.blocked) {
-      info("Release blocked due to conflicting PR labels");
+    if (scopeResult.skipped) {
+      info("Release skipped due to release:skip label");
       return null;
     }
     if (scopeResult.target !== options.target) {
@@ -47147,7 +47168,7 @@ async function runPreview(options) {
   const { options: effectiveOptions, labelContext } = await applyLabelOverrides(options, ciConfig, context, octokit);
   const strategy = ciConfig?.releaseStrategy ?? "direct";
   let result = null;
-  if (!labelContext.noBumpLabel) {
+  if (!labelContext.skip && !labelContext.noBumpLabel) {
     const releaseConfig = loadConfig5({ cwd: effectiveOptions.projectDir, configPath: effectiveOptions.config });
     const prereleaseFlag = resolvePrerelease(
       effectiveOptions,
@@ -47288,25 +47309,26 @@ async function applyLabelOverrides(options, ciConfig, context, existingOctokit)
       labelContext.bumpLabel = "patch";
       result.bump = "patch";
     } else if (matchedScopePatterns.length === 0) {
-      const hasStableOrPrerelease = conflict.hasStable || conflict.hasPrerelease;
-      if (!hasStableOrPrerelease) {
+      if (!conflict.hasStable) {
         labelContext.noBumpLabel = true;
       }
     }
+    if (prLabels.includes(labels.skip)) {
+      warn(
+        `PR label "${labels.skip}" has no effect in label trigger mode \u2014 skipping is controlled by not adding bump labels`
+      );
+    }
   }
   if (!options.stable && options.prerelease === void 0) {
     if (conflict.hasStable && conflict.hasPrerelease) {
     } else if (conflict.hasStable) {
       info(`PR label "${labels.stable}" detected \u2014 using stable release preview`);
       result.stable = true;
+      labelContext.stable = true;
     } else if (conflict.hasPrerelease) {
       info(`PR label "${labels.prerelease}" detected \u2014 using prerelease preview`);
       result.prerelease = true;
-      if (trigger === "label" && !result.bump) {
-        info("No bump label found \u2014 defaulting to patch bump for prerelease release");
-        result.bump = "patch";
-        labelContext.bumpLabel = "patch";
-      }
+      labelContext.prerelease = true;
     }
   }
   return { options: result, labelContext: { ...labelContext, labels } };

package/dist/index.js

@@ -14507,7 +14507,7 @@ var init_baseError_DQHIJACF = __esm({
   }
 });
 
-// ../version/dist/chunk-GHCENMVA.js
+// ../version/dist/chunk-5UIOLBFW.js
 import * as fs8 from "fs";
 import * as path11 from "path";
 import * as TOML2 from "smol-toml";
@@ -15147,6 +15147,10 @@ function bumpVersion(currentVersion, bumpType, prereleaseIdentifier) {
     if (!parsed) {
       return import_semver5.default.inc(currentVersion, bumpType) || "";
     }
+    if (prereleaseIdentifier) {
+      log4(`Incrementing prerelease for ${currentVersion} using 'prerelease'`, "debug");
+      return import_semver5.default.inc(currentVersion, "prerelease", prereleaseIdentifier) || "";
+    }
     if (bumpType === "major" && parsed.minor === 0 && parsed.patch === 0 || bumpType === "minor" && parsed.patch === 0 || bumpType === "patch") {
       log4(`Cleaning prerelease identifier from ${currentVersion} for ${bumpType} bump`, "debug");
       return `${parsed.major}.${parsed.minor}.${parsed.patch}`;
@@ -16110,7 +16114,7 @@ function createAsyncStrategy(config) {
       let packagesToProcess = packages.packages;
       if (targets.length > 0) {
         const beforeCount = packagesToProcess.length;
-        packagesToProcess = packagesToProcess.filter((pkg) => targets.includes(pkg.packageJson.name));
+        packagesToProcess = packagesToProcess.filter((pkg) => shouldMatchPackageTargets(pkg.packageJson.name, targets));
         log4(
           `Runtime targets filter: ${beforeCount} \u2192 ${packagesToProcess.length} packages (${targets.join(", ")})`,
           "info"
@@ -16296,8 +16300,8 @@ function createVersionCommand() {
   });
 }
 var import_semver3, import_semver4, import_semver5, ConfigError2, MAX_JSONC_LENGTH2, GitConfigSchema2, MonorepoConfigSchema2, BranchPatternSchema2, VersionCargoConfigSchema2, VersionConfigSchema2, NpmConfigSchema2, CargoPublishConfigSchema2, PublishGitConfigSchema2, GitHubReleaseConfigSchema2, VerifyRegistryConfigSchema2, VerifyConfigSchema2, PublishConfigSchema2, TemplateConfigSchema2, LocationModeSchema2, ChangelogConfigSchema2, LLMOptionsSchema2, LLMRetryConfigSchema2, LLMTasksConfigSchema2, LLMCategorySchema2, ScopeRulesSchema2, ScopeConfigSchema2, LLMPromptOverridesSchema2, LLMPromptsConfigSchema2, LLMConfigSchema2, ReleaseNotesConfigSchema2, NotesInputConfigSchema2, NotesConfigSchema2, CILabelsConfigSchema2, CIConfigSchema2, ReleaseCIConfigSchema2, ReleaseConfigSchema2, ReleaseKitConfigSchema2, MAX_INPUT_LENGTH2, SOLE_REFERENCE_PATTERN2, AUTH_DIR2, AUTH_FILE2, CONFIG_FILE2, VersionError, VersionErrorCode, _jsonOutputMode, _pendingWrites, _jsonData, STANDARD_BUMP_TYPES, VersionMismatchError, CONVENTIONAL_COMMIT_REGEX, BREAKING_CHANGE_REGEX, PackageProcessor, GitError, VersionEngine;
-var init_chunk_GHCENMVA = __esm({
-  "../version/dist/chunk-GHCENMVA.js"() {
+var init_chunk_5UIOLBFW = __esm({
+  "../version/dist/chunk-5UIOLBFW.js"() {
     "use strict";
     init_chunk_Q3FHZORY();
     init_chunk_LMPZV35Z();
@@ -16559,9 +16563,9 @@ var init_chunk_GHCENMVA = __esm({
       stable: z3.string().default("release:stable"),
       prerelease: z3.string().default("release:prerelease"),
       skip: z3.string().default("release:skip"),
-      major: z3.string().default("release:major"),
-      minor: z3.string().default("release:minor"),
-      patch: z3.string().default("release:patch")
+      major: z3.string().default("bump:major"),
+      minor: z3.string().default("bump:minor"),
+      patch: z3.string().default("bump:patch")
     });
     CIConfigSchema2 = z3.object({
       releaseStrategy: z3.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -16580,9 +16584,9 @@ var init_chunk_GHCENMVA = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -17049,7 +17053,7 @@ __export(dist_exports3, {
 var init_dist13 = __esm({
   "../version/dist/index.js"() {
     "use strict";
-    init_chunk_GHCENMVA();
+    init_chunk_5UIOLBFW();
     init_chunk_Q3FHZORY();
     init_chunk_LMPZV35Z();
   }
@@ -41928,7 +41932,7 @@ var init_aggregator_IUQUAVJC = __esm({
   }
 });
 
-// ../notes/dist/chunk-5B2RYLOK.js
+// ../notes/dist/chunk-R6IWJNYC.js
 import * as TOML3 from "smol-toml";
 import * as fs33 from "fs";
 import * as path33 from "path";
@@ -43260,8 +43264,8 @@ function handleError(err) {
   process.exit(EXIT_CODES.GENERAL_ERROR);
 }
 var import_handlebars, ConfigError3, MAX_JSONC_LENGTH3, GitConfigSchema3, MonorepoConfigSchema3, BranchPatternSchema3, VersionCargoConfigSchema3, VersionConfigSchema3, NpmConfigSchema3, CargoPublishConfigSchema3, PublishGitConfigSchema3, GitHubReleaseConfigSchema3, VerifyRegistryConfigSchema3, VerifyConfigSchema3, PublishConfigSchema3, TemplateConfigSchema3, LocationModeSchema3, ChangelogConfigSchema3, LLMOptionsSchema3, LLMRetryConfigSchema3, LLMTasksConfigSchema3, LLMCategorySchema3, ScopeRulesSchema3, ScopeConfigSchema3, LLMPromptOverridesSchema3, LLMPromptsConfigSchema3, LLMConfigSchema3, ReleaseNotesConfigSchema3, NotesInputConfigSchema3, NotesConfigSchema3, CILabelsConfigSchema3, CIConfigSchema3, ReleaseCIConfigSchema3, ReleaseConfigSchema3, ReleaseKitConfigSchema3, MAX_INPUT_LENGTH3, SOLE_REFERENCE_PATTERN3, AUTH_DIR3, AUTH_FILE3, CONFIG_FILE3, NotesError, InputParseError, TemplateError, LLMError, GitHubError, ConfigError22, LLM_DEFAULTS, BaseLLMProvider, AnthropicProvider, OllamaProvider, OpenAIProvider, OpenAICompatibleProvider, DEFAULT_CATEGORIZE_PROMPT, DEFAULT_ENHANCE_PROMPT, DEFAULT_RELEASE_NOTES_PROMPT, DEFAULT_SUMMARIZE_PROMPT;
-var init_chunk_5B2RYLOK = __esm({
-  "../notes/dist/chunk-5B2RYLOK.js"() {
+var init_chunk_R6IWJNYC = __esm({
+  "../notes/dist/chunk-R6IWJNYC.js"() {
     "use strict";
     init_chunk_7TJSPQPW();
     init_sdk();
@@ -43519,9 +43523,9 @@ var init_chunk_5B2RYLOK = __esm({
       stable: z4.string().default("release:stable"),
       prerelease: z4.string().default("release:prerelease"),
       skip: z4.string().default("release:skip"),
-      major: z4.string().default("release:major"),
-      minor: z4.string().default("release:minor"),
-      patch: z4.string().default("release:patch")
+      major: z4.string().default("bump:major"),
+      minor: z4.string().default("bump:minor"),
+      patch: z4.string().default("bump:patch")
     });
     CIConfigSchema3 = z4.object({
       releaseStrategy: z4.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -43540,9 +43544,9 @@ var init_chunk_5B2RYLOK = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -43936,13 +43940,13 @@ function writeJson(outputPath, contexts, dryRun) {
 var init_dist14 = __esm({
   "../notes/dist/index.js"() {
     "use strict";
-    init_chunk_5B2RYLOK();
+    init_chunk_R6IWJNYC();
     init_chunk_F7MUVHZ2();
     init_chunk_7TJSPQPW();
   }
 });
 
-// ../publish/dist/chunk-UARK5H2F.js
+// ../publish/dist/chunk-ZTUEJDI7.js
 import chalk5 from "chalk";
 import * as fs25 from "fs";
 import * as TOML4 from "smol-toml";
@@ -45479,8 +45483,8 @@ function createPublishCommand() {
   });
 }
 var import_semver6, LOG_LEVELS4, PREFIXES4, COLORS4, currentLevel4, quietMode4, ReleaseKitError4, EXIT_CODES2, ConfigError4, MAX_JSONC_LENGTH4, GitConfigSchema4, MonorepoConfigSchema4, BranchPatternSchema4, VersionCargoConfigSchema4, VersionConfigSchema4, NpmConfigSchema4, CargoPublishConfigSchema4, PublishGitConfigSchema4, GitHubReleaseConfigSchema4, VerifyRegistryConfigSchema4, VerifyConfigSchema4, PublishConfigSchema4, TemplateConfigSchema4, LocationModeSchema4, ChangelogConfigSchema4, LLMOptionsSchema4, LLMRetryConfigSchema4, LLMTasksConfigSchema4, LLMCategorySchema4, ScopeRulesSchema4, ScopeConfigSchema4, LLMPromptOverridesSchema4, LLMPromptsConfigSchema4, LLMConfigSchema4, ReleaseNotesConfigSchema4, NotesInputConfigSchema4, NotesConfigSchema4, CILabelsConfigSchema4, CIConfigSchema4, ReleaseCIConfigSchema4, ReleaseConfigSchema4, ReleaseKitConfigSchema4, MAX_INPUT_LENGTH4, SOLE_REFERENCE_PATTERN4, AUTH_DIR4, AUTH_FILE4, CONFIG_FILE4, BasePublishError, PublishError, PipelineError, PublishErrorCode, VersionChangelogEntrySchema, VersionPackageChangelogSchema, VersionPackageUpdateSchema, VersionOutputSchema;
-var init_chunk_UARK5H2F = __esm({
-  "../publish/dist/chunk-UARK5H2F.js"() {
+var init_chunk_ZTUEJDI7 = __esm({
+  "../publish/dist/chunk-ZTUEJDI7.js"() {
     "use strict";
     import_semver6 = __toESM(require_semver2(), 1);
     LOG_LEVELS4 = {
@@ -45785,9 +45789,9 @@ var init_chunk_UARK5H2F = __esm({
       stable: z5.string().default("release:stable"),
       prerelease: z5.string().default("release:prerelease"),
       skip: z5.string().default("release:skip"),
-      major: z5.string().default("release:major"),
-      minor: z5.string().default("release:minor"),
-      patch: z5.string().default("release:patch")
+      major: z5.string().default("bump:major"),
+      minor: z5.string().default("bump:minor"),
+      patch: z5.string().default("bump:patch")
     });
     CIConfigSchema4 = z5.object({
       releaseStrategy: z5.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -45806,9 +45810,9 @@ var init_chunk_UARK5H2F = __esm({
         stable: "release:stable",
         prerelease: "release:prerelease",
         skip: "release:skip",
-        major: "release:major",
-        minor: "release:minor",
-        patch: "release:patch"
+        major: "bump:major",
+        minor: "bump:minor",
+        patch: "bump:patch"
       }),
       /**
        * Map of scope labels to package patterns.
@@ -45953,7 +45957,7 @@ __export(dist_exports5, {
 var init_dist15 = __esm({
   "../publish/dist/index.js"() {
     "use strict";
-    init_chunk_UARK5H2F();
+    init_chunk_ZTUEJDI7();
   }
 });
 
@@ -46302,9 +46306,9 @@ var CILabelsConfigSchema = z.object({
   stable: z.string().default("release:stable"),
   prerelease: z.string().default("release:prerelease"),
   skip: z.string().default("release:skip"),
-  major: z.string().default("release:major"),
-  minor: z.string().default("release:minor"),
-  patch: z.string().default("release:patch")
+  major: z.string().default("bump:major"),
+  minor: z.string().default("bump:minor"),
+  patch: z.string().default("bump:patch")
 });
 var CIConfigSchema = z.object({
   releaseStrategy: z.enum(["manual", "direct", "standing-pr", "scheduled"]).default("direct"),
@@ -46323,9 +46327,9 @@ var CIConfigSchema = z.object({
     stable: "release:stable",
     prerelease: "release:prerelease",
     skip: "release:skip",
-    major: "release:major",
-    minor: "release:minor",
-    patch: "release:patch"
+    major: "bump:major",
+    minor: "bump:minor",
+    patch: "bump:patch"
   }),
   /**
    * Map of scope labels to package patterns.
@@ -46445,9 +46449,9 @@ var DEFAULT_LABELS = {
   stable: "release:stable",
   prerelease: "release:prerelease",
   skip: "release:skip",
-  major: "release:major",
-  minor: "release:minor",
-  patch: "release:patch"
+  major: "bump:major",
+  minor: "bump:minor",
+  patch: "bump:patch"
 };
 function detectLabelConflicts(prLabels, labels = DEFAULT_LABELS) {
   const bumpLabelsPresent = [
@@ -46612,7 +46616,7 @@ function getLabelBanner(labelContext) {
   if (labelContext.trigger === "label") {
     if (labelContext.bumpConflict) {
       const labels = labelContext.labels;
-      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a release label (e.g., `release:patch`, `release:minor`, `release:major`)";
+      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a bump label (e.g., `bump:patch`, `bump:minor`, `bump:major`)";
       lines.push(
         "> **Error:** Conflicting bump labels detected.",
         `> **Note:** Please use only one release label at a time. Use ${labelExamples}.`,
@@ -46622,12 +46626,28 @@ function getLabelBanner(labelContext) {
     }
     if (labelContext.noBumpLabel) {
       const labels = labelContext.labels;
-      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a release label (e.g., `release:patch`, `release:minor`, `release:major`)";
-      lines.push("> No release label detected.", `> **Note:** Add ${labelExamples} to trigger a release.`, "");
+      const labelExamples = labels ? `\`${labels.patch}\`, \`${labels.minor}\`, or \`${labels.major}\`` : "a bump label (e.g., `bump:patch`, `bump:minor`, `bump:major`)";
+      lines.push("> No bump label detected.", `> **Note:** Add ${labelExamples} to trigger a release.`, "");
       return lines;
     }
     if (labelContext.bumpLabel) {
-      lines.push(`> This PR is labeled for a **${labelContext.bumpLabel}** release.`, "");
+      const parts = [labelContext.bumpLabel];
+      if (labelContext.prerelease) {
+        parts.push("prerelease");
+      }
+      if (labelContext.stable) {
+        parts.push("stable");
+      }
+      const labelText = parts.join(" ");
+      lines.push(`> This PR is labeled for a **${labelText}** release.`, "");
+      return lines;
+    }
+    if (labelContext.stable) {
+      lines.push("> This PR is labeled for a **stable** release (graduation from prerelease).", "");
+      return lines;
+    }
+    if (labelContext.prerelease) {
+      lines.push("> This PR is labeled for a **prerelease** release (bump from conventional commits).", "");
       return lines;
     }
   }
@@ -46833,16 +46853,22 @@ async function applyScopeLabelsFromPR(ciConfig, options) {
   const allLabels = [];
   const perPRLabels = /* @__PURE__ */ new Map();
   for (const prNumber of prNumbers) {
-    const labels = await fetchPRLabels(octokit, githubContext.owner, githubContext.repo, prNumber);
-    allLabels.push(...labels);
-    perPRLabels.set(prNumber, labels);
+    const labels2 = await fetchPRLabels(octokit, githubContext.owner, githubContext.repo, prNumber);
+    allLabels.push(...labels2);
+    perPRLabels.set(prNumber, labels2);
   }
-  for (const [prNumber, labels] of perPRLabels) {
-    const conflict = detectLabelConflicts(labels, ciConfig?.labels ?? DEFAULT_LABELS);
+  const labels = ciConfig?.labels ?? DEFAULT_LABELS;
+  for (const [prNumber, prLabels] of perPRLabels) {
+    const conflict = detectLabelConflicts(prLabels, labels);
+    if ((ciConfig?.releaseTrigger ?? "label") === "commit" && prLabels.includes(labels.skip)) {
+      info(`PR #${prNumber} has "${labels.skip}" label \u2014 skipping release`);
+      return { target: options.target, scopeLabels: [], labels: [], skipped: true };
+    }
+    if (prLabels.includes(labels.skip)) {
+      warn(`PR #${prNumber} has "${labels.skip}" label \u2014 this has no effect in label trigger mode`);
+    }
     if (conflict.prereleaseConflict) {
-      warn(
-        `PR #${prNumber} has conflicting labels "${ciConfig?.labels?.stable ?? "release:stable"}" and "${ciConfig?.labels?.prerelease ?? "release:prerelease"}" \u2014 release blocked`
-      );
+      warn(`PR #${prNumber} has conflicting labels "${labels.stable}" and "${labels.prerelease}" \u2014 release blocked`);
       return { target: options.target, scopeLabels: [], labels: [], blocked: true };
     }
     if (conflict.bumpConflict && (ciConfig?.releaseTrigger ?? "label") === "label") {
@@ -46894,19 +46920,14 @@ async function runRelease(inputOptions) {
   }
   const releaseConfig = releaseKitConfig.release;
   const ciConfig = loadCIConfig({ cwd: options.projectDir, configPath: options.config });
-  if (!options.dryRun) {
+  if (!options.dryRun || ciConfig?.scopeLabels) {
     const scopeResult = await applyScopeLabelsFromPR(ciConfig, options);
     if (scopeResult.blocked) {
       info("Release blocked due to conflicting PR labels");
       return null;
     }
-    if (scopeResult.target !== options.target) {
-      options.target = scopeResult.target;
-    }
-  } else if (ciConfig?.scopeLabels) {
-    const scopeResult = await applyScopeLabelsFromPR(ciConfig, options);
-    if (scopeResult.blocked) {
-      info("Release blocked due to conflicting PR labels");
+    if (scopeResult.skipped) {
+      info("Release skipped due to release:skip label");
       return null;
     }
     if (scopeResult.target !== options.target) {
@@ -47061,7 +47082,7 @@ async function runPreview(options) {
   const { options: effectiveOptions, labelContext } = await applyLabelOverrides(options, ciConfig, context, octokit);
   const strategy = ciConfig?.releaseStrategy ?? "direct";
   let result = null;
-  if (!labelContext.noBumpLabel) {
+  if (!labelContext.skip && !labelContext.noBumpLabel) {
     const releaseConfig = loadConfig({ cwd: effectiveOptions.projectDir, configPath: effectiveOptions.config });
     const prereleaseFlag = resolvePrerelease(
       effectiveOptions,
@@ -47202,25 +47223,26 @@ async function applyLabelOverrides(options, ciConfig, context, existingOctokit)
       labelContext.bumpLabel = "patch";
       result.bump = "patch";
     } else if (matchedScopePatterns.length === 0) {
-      const hasStableOrPrerelease = conflict.hasStable || conflict.hasPrerelease;
-      if (!hasStableOrPrerelease) {
+      if (!conflict.hasStable) {
         labelContext.noBumpLabel = true;
       }
     }
+    if (prLabels.includes(labels.skip)) {
+      warn(
+        `PR label "${labels.skip}" has no effect in label trigger mode \u2014 skipping is controlled by not adding bump labels`
+      );
+    }
   }
   if (!options.stable && options.prerelease === void 0) {
     if (conflict.hasStable && conflict.hasPrerelease) {
     } else if (conflict.hasStable) {
       info(`PR label "${labels.stable}" detected \u2014 using stable release preview`);
       result.stable = true;
+      labelContext.stable = true;
     } else if (conflict.hasPrerelease) {
       info(`PR label "${labels.prerelease}" detected \u2014 using prerelease preview`);
       result.prerelease = true;
-      if (trigger === "label" && !result.bump) {
-        info("No bump label found \u2014 defaulting to patch bump for prerelease release");
-        result.bump = "patch";
-        labelContext.bumpLabel = "patch";
-      }
+      labelContext.prerelease = true;
     }
   }
   return { options: result, labelContext: { ...labelContext, labels } };

package/docs/ci-setup.md

@@ -60,12 +60,28 @@ Only release when a PR is merged with a release label. Conventional commits dete
 
 | Label | Effect |
 |-------|--------|
-| `release:patch` | Bump patch version |
-| `release:minor` | Bump minor version |
-| `release:major` | Bump major version |
-| `release:stable` | Graduate a prerelease to stable |
-| `release:prerelease` | Create a prerelease |
-| `release:skip` | Suppress release on this PR |
+| `bump:patch` | Bump patch version |
+| `bump:minor` | Bump minor version |
+| `bump:major` | Bump major version |
+| `release:stable` | Promote a prerelease to stable (e.g. `1.0.0-next.6` → `1.0.0`). Can be used alone — no bump label needed. Has no effect on stable versions. |
+| `release:prerelease` | Channel modifier — must be combined with a `bump:*` label. Alone, no release is triggered. |
+| `release:skip` | Suppress release on this PR (commit trigger mode only) |
+
+#### Label combinations
+
+| Labels | Current version | Result |
+|--------|-----------------|--------|
+| `bump:patch` | `1.0.0` | `1.0.1` |
+| `bump:minor` | `1.0.0` | `1.1.0` |
+| `bump:major` | `1.0.0` | `2.0.0` |
+| `release:prerelease` + `bump:patch` | `1.0.0` | `1.0.1-next.0` |
+| `release:prerelease` + `bump:minor` | `1.0.0` | `1.1.0-next.0` |
+| `release:prerelease` + `bump:major` | `1.0.0` | `2.0.0-next.0` |
+| `release:prerelease` + `bump:patch` | `1.0.0-next.6` | `1.0.0-next.7` |
+| `release:prerelease` alone | any | No release — add a `bump:*` label |
+| `release:stable` alone | `1.0.0-next.6` | `1.0.0` |
+| `release:stable` alone | `1.0.0` | No prerelease effect — bump (if any) from conventional commits |
+| `release:stable` + any `bump:*` | `1.0.0-next.6` | `1.0.0` — bump label is ignored during stable promotion |
 
 ```yaml
 # .github/workflows/release.yml
@@ -107,16 +123,16 @@ Configure the trigger in `releasekit.config.json`:
   "ci": {
     "releaseTrigger": "label",
     "labels": {
-      "major": "release:major",
-      "minor": "release:minor",
-      "patch": "release:patch",
+      "major": "bump:major",
+      "minor": "bump:minor",
+      "patch": "bump:patch",
       "skip": "release:skip"
     }
   }
 }
 ```
 
-Without a `release:patch/minor/major` label on the merged PR, no release is triggered. The `labels` block shown above reflects the defaults — omit it if your repository already uses those label names.
+Without a `bump:patch/minor/major` label on the merged PR, no release is triggered. The `labels` block shown above reflects the defaults — omit it if your repository already uses those label names.
 
 See [@releasekit/release — CI Configuration](../README.md#ci-configuration) for all `ci.*` options.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@releasekit/release",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "Unified release pipeline: version, changelog, and publish in a single command",
   "type": "module",
   "module": "./dist/index.js",
@@ -50,9 +50,9 @@
     "conventional-changelog-conventionalcommits": "^9.3.0",
     "smol-toml": "^1.6.1",
     "zod": "^4.3.6",
-    "@releasekit/publish": "0.8.1",
-    "@releasekit/version": "0.8.1",
-    "@releasekit/notes": "0.8.1"
+    "@releasekit/notes": "0.10.0",
+    "@releasekit/publish": "0.10.0",
+    "@releasekit/version": "0.10.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.10",
@@ -62,8 +62,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.2",
-    "@releasekit/core": "0.0.0",
-    "@releasekit/config": "0.0.0"
+    "@releasekit/config": "0.0.0",
+    "@releasekit/core": "0.0.0"
   },
   "engines": {
     "node": ">=20"