relizy 1.4.5 → 1.4.7

package/dist/cli.mjs

@@ -5,7 +5,7 @@ import process from 'node:process';
 import { fileURLToPath } from 'node:url';
 import { printBanner, logger } from '@maz-ui/node';
 import { Command } from 'commander';
-import { aq as isInCI, ar as getCIName, b as bump, c as changelog, g as publish, e as providerRelease, h as social, p as prComment, r as release } from './shared/relizy.-Cr2hO3N.mjs';
+import { ay as isInCI, az as getCIName, b as bump, c as changelog, g as publish, e as providerRelease, h as social, p as prComment, r as release } from './shared/relizy.d-S4lcvu.mjs';
 import 'node:child_process';
 import '@maz-ui/utils';
 import 'c12';

package/dist/index.d.mts

@@ -69,6 +69,7 @@ declare function getDefaultConfig(): {
     ai: AIConfig;
     logLevel: LogLevel;
     safetyCheck: boolean;
+    detectRewrittenTags: boolean;
 };
 /**
  * Merge user types with defaults: each user-defined entry replaces the default entirely.
@@ -88,19 +89,41 @@ type ResolvedRelizyConfig = ResolvedConfig & {
 declare function defineConfig(config: RelizyConfig): RelizyConfig;
 
 /**
- * Generate changelog for a specific package
+ * Controls which sections of the rendered changelog are produced.
+ * Each flag defaults to `true`. `compareLink` and `contributors` are
+ * additionally suppressed when `minify: true` (see `generateChangelog`).
  */
-declare function generateChangelog({ pkg, config, dryRun, newVersion, minify, }: {
+interface ChangelogInclude {
+    title?: boolean;
+    compareLink?: boolean;
+    body?: boolean;
+    contributors?: boolean;
+}
+/**
+ * Generate the changelog string for a single package.
+ *
+ * - Fetches commits internally using `changelog: true`, so types that only
+ *   declare a `title` (e.g. `docs: { title: '📖 Documentation' }`) are
+ *   included even though they don't trigger a version bump. Callers must
+ *   provide `pkg.path` — `pkg.commits` is no longer consumed.
+ * - `include` toggles which sections appear in the output. `compareLink`
+ *   and `contributors` are also skipped when `minify` is true.
+ * - `transformBody` is invoked between body rendering and final assembly,
+ *   used by provider releases to plug an AI rewrite step on the body only.
+ */
+declare function generateChangelog({ pkg, config, dryRun, newVersion, minify, include, transformBody, }: {
     pkg: {
         fromTag?: string;
         name: string;
+        path: string;
         newVersion?: string;
-        commits: GitCommit[];
     };
     config: ResolvedRelizyConfig;
     dryRun: boolean;
     newVersion: string;
     minify?: boolean;
+    include?: ChangelogInclude;
+    transformBody?: (body: string) => Promise<string> | string;
 }): Promise<string>;
 /**
  * Write changelog to file
@@ -188,6 +211,44 @@ declare function getCurrentGitBranch(cwd: string): string;
 declare function getCurrentGitRef(cwd: string): string;
 declare function getShortCommitSha(cwd: string, length?: number): string;
 
+/**
+ * Returns true when `ancestor` is an ancestor of `descendant` (i.e. reachable
+ * from it). Uses `git merge-base --is-ancestor`, which exits 0 when true and
+ * non-zero otherwise. Any error (e.g. unknown ref) is treated as "not an
+ * ancestor".
+ */
+declare function isAncestor(ancestor: string, descendant: string, cwd?: string): Promise<boolean>;
+/**
+ * Returns the subject (first line) of the commit a ref points to, or null.
+ */
+declare function getCommitSubject(ref: string, cwd?: string): Promise<string | null>;
+/**
+ * Find the most recent commit reachable from `to` whose subject matches
+ * `subject` literally. Used to locate the "twin" of a release commit that was
+ * rewritten by a rebase (the orphaned tag still points to the old commit).
+ */
+declare function findReachableCommitBySubject(subject: string, to: string, cwd?: string): Promise<string | null>;
+/**
+ * Returns true when a tag with the given name exists locally.
+ */
+declare function tagExists(tag: string, cwd?: string): Promise<boolean>;
+/**
+ * Move an annotated tag to a different commit locally (force). Never rewrites
+ * any commit; only the tag pointer moves.
+ */
+declare function retagAnnotatedLocal({ tag, commit, message, signed, cwd, logLevel, }: {
+    tag: string;
+    commit: string;
+    message: string;
+    signed?: boolean;
+    cwd?: string;
+    logLevel?: LogLevel;
+}): Promise<void>;
+/**
+ * Force-push a single tag to origin. Used only after explicit confirmation.
+ */
+declare function pushTagForce(tag: string, cwd?: string, logLevel?: LogLevel): Promise<void>;
+
 declare function github(options: ProviderReleaseOptions): Promise<PostedRelease[]>;
 
 interface GitlabRelease {
@@ -355,13 +416,14 @@ interface RootPackage extends ReadPackage {
     commits: GitCommit[];
     newVersion?: string;
 }
-declare function getRootPackage({ config, force, from, to, suffix, changelog, }: {
+declare function getRootPackage({ config, force, from, to, suffix, changelog, dryRun, }: {
     config: ResolvedRelizyConfig;
     force: boolean;
     from: string;
     to: string;
     suffix: string | undefined;
     changelog: boolean;
+    dryRun?: boolean;
 }): Promise<RootPackage>;
 declare function readPackages({ cwd, patterns, ignorePackageNames, includePrivates, }: {
     cwd: string;
@@ -369,21 +431,42 @@ declare function readPackages({ cwd, patterns, ignorePackageNames, includePrivat
     ignorePackageNames: NonNullable<ResolvedRelizyConfig['monorepo']>['ignorePackageNames'];
     includePrivates?: boolean;
 }): ReadPackage[];
-declare function getPackages({ config, suffix, force, includeAll, }: {
+declare function getPackages({ config, suffix, force, includeAll, dryRun, }: {
     config: ResolvedRelizyConfig;
     suffix: string | undefined;
     force: boolean;
     includeAll?: boolean;
+    dryRun?: boolean;
 }): Promise<PackageBase[]>;
-declare function getPackageCommits({ pkg, from, to, config, changelog, }: {
+declare function getPackageCommits({ pkg, from, to, config, changelog, dryRun, }: {
     pkg: ReadPackage;
     from: string;
     to: string;
     config: ResolvedRelizyConfig;
     changelog: boolean;
+    dryRun?: boolean;
 }): Promise<GitCommit[]>;
 declare function hasLernaJson(rootDir: string): boolean;
 
+/** Test helper: clear the per-process decision cache. */
+declare function resetRewrittenTagCache(): void;
+/**
+ * Ensure the resolved `from` tag is reachable from `to`. When it is not (a
+ * rewritten / orphaned tag), explain the situation and either prompt the user
+ * or auto-correct, depending on the configured strategy. Returns the effective
+ * `from` to use (the original tag, the rebound tag, or the equivalent commit
+ * SHA for an ephemeral correction).
+ *
+ * No commit is ever rewritten; the only mutation possible is moving a tag.
+ */
+declare function reconcileFromTag({ from, to, config, dryRun, }: {
+    from: string;
+    to: string;
+    config: ResolvedRelizyConfig;
+    pkg?: ReadPackage;
+    dryRun?: boolean;
+}): Promise<string>;
+
 /**
  * Get Slack token from config
  * Priority: social.slack.credentials > config.tokens.slack > environment variables (handled in config.ts)
@@ -541,11 +624,12 @@ declare function isBumpedPackage(pkg: PackageBase): pkg is PackageBase & {
 declare function filterOutPrivatePackages<T extends {
     private: boolean;
 }>(packages: T[]): T[];
-declare function getPackagesOrBumpedPackages({ config, bumpResult, suffix, force, }: {
+declare function getPackagesOrBumpedPackages({ config, bumpResult, suffix, force, dryRun, }: {
     config: ResolvedRelizyConfig;
     bumpResult: BumpResultTruthy | undefined;
     suffix: string | undefined;
     force: boolean;
+    dryRun?: boolean;
 }): Promise<PackageBase[]>;
 
 declare function isGraduatingToStableBetweenVersion(version: string, newVersion: string): boolean;
@@ -1742,6 +1826,7 @@ type HookConfig = {
  * Relizy configuration
  * @see https://relizy.dev/config/overview
  */
+type OnRewrittenTag = 'prompt' | 'ephemeral' | 'rebind' | 'error';
 interface RelizyConfig extends Partial<Omit<ChangelogConfig$1, 'output' | 'templates' | 'publish' | 'types' | 'tokens'>> {
     /**
      * Project name
@@ -1823,6 +1908,24 @@ interface RelizyConfig extends Partial<Omit<ChangelogConfig$1, 'output' | 'templ
      * @default true
      */
     safetyCheck?: boolean;
+    /**
+     * Detect when the resolved `from` tag points to a commit that is no longer
+     * reachable from `to` (typically because the history was rebased after the
+     * tag was created). When enabled, relizy explains the situation and either
+     * prompts or auto-corrects, avoiding bloated changelogs and over-bumping.
+     * @default true
+     */
+    detectRewrittenTags?: boolean;
+    /**
+     * Strategy applied when a rewritten/orphaned `from` tag is detected.
+     * Defaults to `prompt` interactively, or `ephemeral` when non-interactive
+     * (`--yes` / no TTY / CI).
+     * - `prompt`: interactive selection.
+     * - `ephemeral`: use the reachable equivalent commit for this run only.
+     * - `rebind`: move the local tag onto the equivalent commit (no push).
+     * - `error`: throw and stop.
+     */
+    onRewrittenTag?: OnRewrittenTag;
 }
 
 declare function bump(options?: Partial<BumpOptions>): Promise<BumpResult>;
@@ -1875,5 +1978,5 @@ declare function socialSafetyCheck({ config }: {
 }): Promise<void>;
 declare function social(options?: Partial<SocialOptions>): Promise<SocialResult>;
 
-export { NEW_PACKAGE_MARKER, PR_COMMENT_MARKER, buildChangelogBody, buildCommentBody, buildCompareLink, buildContributors, bump, capReleaseTypeForZeroMajor, changelog, checkGitStatusIfDirty, collectContributorNames, collectPackageBumps, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, formatChangelogForSlack, formatPackagesForSlack, formatSlackMessage, formatTweetMessage, generateChangelog, generateMarkDown, getAuthCommand, getBumpedIndependentPackages, getBumpedPackageIndependently, getCIName, getCanaryVersion, getCurrentGitBranch, getCurrentGitRef, getDefaultConfig, getDependentsOf, getFirstCommit, getGitStatus, getIndependentTag, getLastPackageTag, getLastRepoTag, getLastStableTag, getLastTag, getModifiedReleaseFilePatterns, getPackageCommits, getPackageDependencies, getPackageNewVersion, getPackages, getPackagesOrBumpedPackages, getPackagesToPublishInIndependentMode, getPackagesToPublishInSelectiveMode, getPreid, getReleaseUrl, getRootPackage, getShortCommitSha, getSlackToken, getSlackWebhookUrl, getTwitterCredentials, github, gitlab, hasLernaJson, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, mergeTypes, parseChangelogMarkdown, parseGitRemoteUrl, postPrComment, postReleaseToSlack, postReleaseToTwitter, prComment, providerRelease, providerReleaseSafetyCheck, publish, publishPackage, publishSafetyCheck, pushCommitAndTags, readPackageJson, readPackages, release, resolveTags, rollbackModifiedFiles, shouldFilterPrereleaseTags, social, socialSafetyCheck, topologicalSort, updateLernaVersion, writeChangelogToFile, writeVersion };
-export type { AIConfig, AIPromptTarget, AIProviderName, AISocialConfig, AISystemPromptOverrides, AITargetConfig, BumpConfig, BumpOptions, BumpResult, BumpResultFalsy, BumpResultTruthy, ChangelogConfig, ChangelogOptions, ClaudeCodeProviderOptions, ConfigType, GitProvider, GitlabRelease, GitlabReleaseResponse, HookConfig, HookStep, HookType, MonorepoConfig, PackageBase, PackageBumpEntry, PackageManager, PostedRelease, PrCommentConfig, PrCommentMode, PrCommentOptions, PrCommentStatus, ProviderReleaseOptions, ProviderReleaseResult, PublishConfig, PublishOptions, PublishResponse, PullRequestInfo, ReadPackage, Reference, ReleaseConfig, ReleaseContext, ReleaseOptions, RelizyConfig, RepoConfig, ResolvedConfig, ResolvedRelizyConfig, ResolvedTags, ResolvedTwitterCredentials, RootPackage, SlackCredentials, SlackOptions, SlackPackageEntry, SlackSocialConfig, SocialConfig, SocialNetworkResult, SocialOptions, SocialResult, Step, TemplatesConfig, TokensConfig, TwitterCredentials, TwitterOptions, TwitterSocialConfig, VersionMode };
+export { NEW_PACKAGE_MARKER, PR_COMMENT_MARKER, buildChangelogBody, buildCommentBody, buildCompareLink, buildContributors, bump, capReleaseTypeForZeroMajor, changelog, checkGitStatusIfDirty, collectContributorNames, collectPackageBumps, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, findReachableCommitBySubject, formatChangelogForSlack, formatPackagesForSlack, formatSlackMessage, formatTweetMessage, generateChangelog, generateMarkDown, getAuthCommand, getBumpedIndependentPackages, getBumpedPackageIndependently, getCIName, getCanaryVersion, getCommitSubject, getCurrentGitBranch, getCurrentGitRef, getDefaultConfig, getDependentsOf, getFirstCommit, getGitStatus, getIndependentTag, getLastPackageTag, getLastRepoTag, getLastStableTag, getLastTag, getModifiedReleaseFilePatterns, getPackageCommits, getPackageDependencies, getPackageNewVersion, getPackages, getPackagesOrBumpedPackages, getPackagesToPublishInIndependentMode, getPackagesToPublishInSelectiveMode, getPreid, getReleaseUrl, getRootPackage, getShortCommitSha, getSlackToken, getSlackWebhookUrl, getTwitterCredentials, github, gitlab, hasLernaJson, isAncestor, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, mergeTypes, parseChangelogMarkdown, parseGitRemoteUrl, postPrComment, postReleaseToSlack, postReleaseToTwitter, prComment, providerRelease, providerReleaseSafetyCheck, publish, publishPackage, publishSafetyCheck, pushCommitAndTags, pushTagForce, readPackageJson, readPackages, reconcileFromTag, release, resetRewrittenTagCache, resolveTags, retagAnnotatedLocal, rollbackModifiedFiles, shouldFilterPrereleaseTags, social, socialSafetyCheck, tagExists, topologicalSort, updateLernaVersion, writeChangelogToFile, writeVersion };
+export type { AIConfig, AIPromptTarget, AIProviderName, AISocialConfig, AISystemPromptOverrides, AITargetConfig, BumpConfig, BumpOptions, BumpResult, BumpResultFalsy, BumpResultTruthy, ChangelogConfig, ChangelogInclude, ChangelogOptions, ClaudeCodeProviderOptions, ConfigType, GitProvider, GitlabRelease, GitlabReleaseResponse, HookConfig, HookStep, HookType, MonorepoConfig, OnRewrittenTag, PackageBase, PackageBumpEntry, PackageManager, PostedRelease, PrCommentConfig, PrCommentMode, PrCommentOptions, PrCommentStatus, ProviderReleaseOptions, ProviderReleaseResult, PublishConfig, PublishOptions, PublishResponse, PullRequestInfo, ReadPackage, Reference, ReleaseConfig, ReleaseContext, ReleaseOptions, RelizyConfig, RepoConfig, ResolvedConfig, ResolvedRelizyConfig, ResolvedTags, ResolvedTwitterCredentials, RootPackage, SlackCredentials, SlackOptions, SlackPackageEntry, SlackSocialConfig, SocialConfig, SocialNetworkResult, SocialOptions, SocialResult, Step, TemplatesConfig, TokensConfig, TwitterCredentials, TwitterOptions, TwitterSocialConfig, VersionMode };

package/dist/index.d.ts

@@ -69,6 +69,7 @@ declare function getDefaultConfig(): {
     ai: AIConfig;
     logLevel: LogLevel;
     safetyCheck: boolean;
+    detectRewrittenTags: boolean;
 };
 /**
  * Merge user types with defaults: each user-defined entry replaces the default entirely.
@@ -88,19 +89,41 @@ type ResolvedRelizyConfig = ResolvedConfig & {
 declare function defineConfig(config: RelizyConfig): RelizyConfig;
 
 /**
- * Generate changelog for a specific package
+ * Controls which sections of the rendered changelog are produced.
+ * Each flag defaults to `true`. `compareLink` and `contributors` are
+ * additionally suppressed when `minify: true` (see `generateChangelog`).
  */
-declare function generateChangelog({ pkg, config, dryRun, newVersion, minify, }: {
+interface ChangelogInclude {
+    title?: boolean;
+    compareLink?: boolean;
+    body?: boolean;
+    contributors?: boolean;
+}
+/**
+ * Generate the changelog string for a single package.
+ *
+ * - Fetches commits internally using `changelog: true`, so types that only
+ *   declare a `title` (e.g. `docs: { title: '📖 Documentation' }`) are
+ *   included even though they don't trigger a version bump. Callers must
+ *   provide `pkg.path` — `pkg.commits` is no longer consumed.
+ * - `include` toggles which sections appear in the output. `compareLink`
+ *   and `contributors` are also skipped when `minify` is true.
+ * - `transformBody` is invoked between body rendering and final assembly,
+ *   used by provider releases to plug an AI rewrite step on the body only.
+ */
+declare function generateChangelog({ pkg, config, dryRun, newVersion, minify, include, transformBody, }: {
     pkg: {
         fromTag?: string;
         name: string;
+        path: string;
         newVersion?: string;
-        commits: GitCommit[];
     };
     config: ResolvedRelizyConfig;
     dryRun: boolean;
     newVersion: string;
     minify?: boolean;
+    include?: ChangelogInclude;
+    transformBody?: (body: string) => Promise<string> | string;
 }): Promise<string>;
 /**
  * Write changelog to file
@@ -188,6 +211,44 @@ declare function getCurrentGitBranch(cwd: string): string;
 declare function getCurrentGitRef(cwd: string): string;
 declare function getShortCommitSha(cwd: string, length?: number): string;
 
+/**
+ * Returns true when `ancestor` is an ancestor of `descendant` (i.e. reachable
+ * from it). Uses `git merge-base --is-ancestor`, which exits 0 when true and
+ * non-zero otherwise. Any error (e.g. unknown ref) is treated as "not an
+ * ancestor".
+ */
+declare function isAncestor(ancestor: string, descendant: string, cwd?: string): Promise<boolean>;
+/**
+ * Returns the subject (first line) of the commit a ref points to, or null.
+ */
+declare function getCommitSubject(ref: string, cwd?: string): Promise<string | null>;
+/**
+ * Find the most recent commit reachable from `to` whose subject matches
+ * `subject` literally. Used to locate the "twin" of a release commit that was
+ * rewritten by a rebase (the orphaned tag still points to the old commit).
+ */
+declare function findReachableCommitBySubject(subject: string, to: string, cwd?: string): Promise<string | null>;
+/**
+ * Returns true when a tag with the given name exists locally.
+ */
+declare function tagExists(tag: string, cwd?: string): Promise<boolean>;
+/**
+ * Move an annotated tag to a different commit locally (force). Never rewrites
+ * any commit; only the tag pointer moves.
+ */
+declare function retagAnnotatedLocal({ tag, commit, message, signed, cwd, logLevel, }: {
+    tag: string;
+    commit: string;
+    message: string;
+    signed?: boolean;
+    cwd?: string;
+    logLevel?: LogLevel;
+}): Promise<void>;
+/**
+ * Force-push a single tag to origin. Used only after explicit confirmation.
+ */
+declare function pushTagForce(tag: string, cwd?: string, logLevel?: LogLevel): Promise<void>;
+
 declare function github(options: ProviderReleaseOptions): Promise<PostedRelease[]>;
 
 interface GitlabRelease {
@@ -355,13 +416,14 @@ interface RootPackage extends ReadPackage {
     commits: GitCommit[];
     newVersion?: string;
 }
-declare function getRootPackage({ config, force, from, to, suffix, changelog, }: {
+declare function getRootPackage({ config, force, from, to, suffix, changelog, dryRun, }: {
     config: ResolvedRelizyConfig;
     force: boolean;
     from: string;
     to: string;
     suffix: string | undefined;
     changelog: boolean;
+    dryRun?: boolean;
 }): Promise<RootPackage>;
 declare function readPackages({ cwd, patterns, ignorePackageNames, includePrivates, }: {
     cwd: string;
@@ -369,21 +431,42 @@ declare function readPackages({ cwd, patterns, ignorePackageNames, includePrivat
     ignorePackageNames: NonNullable<ResolvedRelizyConfig['monorepo']>['ignorePackageNames'];
     includePrivates?: boolean;
 }): ReadPackage[];
-declare function getPackages({ config, suffix, force, includeAll, }: {
+declare function getPackages({ config, suffix, force, includeAll, dryRun, }: {
     config: ResolvedRelizyConfig;
     suffix: string | undefined;
     force: boolean;
     includeAll?: boolean;
+    dryRun?: boolean;
 }): Promise<PackageBase[]>;
-declare function getPackageCommits({ pkg, from, to, config, changelog, }: {
+declare function getPackageCommits({ pkg, from, to, config, changelog, dryRun, }: {
     pkg: ReadPackage;
     from: string;
     to: string;
     config: ResolvedRelizyConfig;
     changelog: boolean;
+    dryRun?: boolean;
 }): Promise<GitCommit[]>;
 declare function hasLernaJson(rootDir: string): boolean;
 
+/** Test helper: clear the per-process decision cache. */
+declare function resetRewrittenTagCache(): void;
+/**
+ * Ensure the resolved `from` tag is reachable from `to`. When it is not (a
+ * rewritten / orphaned tag), explain the situation and either prompt the user
+ * or auto-correct, depending on the configured strategy. Returns the effective
+ * `from` to use (the original tag, the rebound tag, or the equivalent commit
+ * SHA for an ephemeral correction).
+ *
+ * No commit is ever rewritten; the only mutation possible is moving a tag.
+ */
+declare function reconcileFromTag({ from, to, config, dryRun, }: {
+    from: string;
+    to: string;
+    config: ResolvedRelizyConfig;
+    pkg?: ReadPackage;
+    dryRun?: boolean;
+}): Promise<string>;
+
 /**
  * Get Slack token from config
  * Priority: social.slack.credentials > config.tokens.slack > environment variables (handled in config.ts)
@@ -541,11 +624,12 @@ declare function isBumpedPackage(pkg: PackageBase): pkg is PackageBase & {
 declare function filterOutPrivatePackages<T extends {
     private: boolean;
 }>(packages: T[]): T[];
-declare function getPackagesOrBumpedPackages({ config, bumpResult, suffix, force, }: {
+declare function getPackagesOrBumpedPackages({ config, bumpResult, suffix, force, dryRun, }: {
     config: ResolvedRelizyConfig;
     bumpResult: BumpResultTruthy | undefined;
     suffix: string | undefined;
     force: boolean;
+    dryRun?: boolean;
 }): Promise<PackageBase[]>;
 
 declare function isGraduatingToStableBetweenVersion(version: string, newVersion: string): boolean;
@@ -1742,6 +1826,7 @@ type HookConfig = {
  * Relizy configuration
  * @see https://relizy.dev/config/overview
  */
+type OnRewrittenTag = 'prompt' | 'ephemeral' | 'rebind' | 'error';
 interface RelizyConfig extends Partial<Omit<ChangelogConfig$1, 'output' | 'templates' | 'publish' | 'types' | 'tokens'>> {
     /**
      * Project name
@@ -1823,6 +1908,24 @@ interface RelizyConfig extends Partial<Omit<ChangelogConfig$1, 'output' | 'templ
      * @default true
      */
     safetyCheck?: boolean;
+    /**
+     * Detect when the resolved `from` tag points to a commit that is no longer
+     * reachable from `to` (typically because the history was rebased after the
+     * tag was created). When enabled, relizy explains the situation and either
+     * prompts or auto-corrects, avoiding bloated changelogs and over-bumping.
+     * @default true
+     */
+    detectRewrittenTags?: boolean;
+    /**
+     * Strategy applied when a rewritten/orphaned `from` tag is detected.
+     * Defaults to `prompt` interactively, or `ephemeral` when non-interactive
+     * (`--yes` / no TTY / CI).
+     * - `prompt`: interactive selection.
+     * - `ephemeral`: use the reachable equivalent commit for this run only.
+     * - `rebind`: move the local tag onto the equivalent commit (no push).
+     * - `error`: throw and stop.
+     */
+    onRewrittenTag?: OnRewrittenTag;
 }
 
 declare function bump(options?: Partial<BumpOptions>): Promise<BumpResult>;
@@ -1875,5 +1978,5 @@ declare function socialSafetyCheck({ config }: {
 }): Promise<void>;
 declare function social(options?: Partial<SocialOptions>): Promise<SocialResult>;
 
-export { NEW_PACKAGE_MARKER, PR_COMMENT_MARKER, buildChangelogBody, buildCommentBody, buildCompareLink, buildContributors, bump, capReleaseTypeForZeroMajor, changelog, checkGitStatusIfDirty, collectContributorNames, collectPackageBumps, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, formatChangelogForSlack, formatPackagesForSlack, formatSlackMessage, formatTweetMessage, generateChangelog, generateMarkDown, getAuthCommand, getBumpedIndependentPackages, getBumpedPackageIndependently, getCIName, getCanaryVersion, getCurrentGitBranch, getCurrentGitRef, getDefaultConfig, getDependentsOf, getFirstCommit, getGitStatus, getIndependentTag, getLastPackageTag, getLastRepoTag, getLastStableTag, getLastTag, getModifiedReleaseFilePatterns, getPackageCommits, getPackageDependencies, getPackageNewVersion, getPackages, getPackagesOrBumpedPackages, getPackagesToPublishInIndependentMode, getPackagesToPublishInSelectiveMode, getPreid, getReleaseUrl, getRootPackage, getShortCommitSha, getSlackToken, getSlackWebhookUrl, getTwitterCredentials, github, gitlab, hasLernaJson, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, mergeTypes, parseChangelogMarkdown, parseGitRemoteUrl, postPrComment, postReleaseToSlack, postReleaseToTwitter, prComment, providerRelease, providerReleaseSafetyCheck, publish, publishPackage, publishSafetyCheck, pushCommitAndTags, readPackageJson, readPackages, release, resolveTags, rollbackModifiedFiles, shouldFilterPrereleaseTags, social, socialSafetyCheck, topologicalSort, updateLernaVersion, writeChangelogToFile, writeVersion };
-export type { AIConfig, AIPromptTarget, AIProviderName, AISocialConfig, AISystemPromptOverrides, AITargetConfig, BumpConfig, BumpOptions, BumpResult, BumpResultFalsy, BumpResultTruthy, ChangelogConfig, ChangelogOptions, ClaudeCodeProviderOptions, ConfigType, GitProvider, GitlabRelease, GitlabReleaseResponse, HookConfig, HookStep, HookType, MonorepoConfig, PackageBase, PackageBumpEntry, PackageManager, PostedRelease, PrCommentConfig, PrCommentMode, PrCommentOptions, PrCommentStatus, ProviderReleaseOptions, ProviderReleaseResult, PublishConfig, PublishOptions, PublishResponse, PullRequestInfo, ReadPackage, Reference, ReleaseConfig, ReleaseContext, ReleaseOptions, RelizyConfig, RepoConfig, ResolvedConfig, ResolvedRelizyConfig, ResolvedTags, ResolvedTwitterCredentials, RootPackage, SlackCredentials, SlackOptions, SlackPackageEntry, SlackSocialConfig, SocialConfig, SocialNetworkResult, SocialOptions, SocialResult, Step, TemplatesConfig, TokensConfig, TwitterCredentials, TwitterOptions, TwitterSocialConfig, VersionMode };
+export { NEW_PACKAGE_MARKER, PR_COMMENT_MARKER, buildChangelogBody, buildCommentBody, buildCompareLink, buildContributors, bump, capReleaseTypeForZeroMajor, changelog, checkGitStatusIfDirty, collectContributorNames, collectPackageBumps, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, findReachableCommitBySubject, formatChangelogForSlack, formatPackagesForSlack, formatSlackMessage, formatTweetMessage, generateChangelog, generateMarkDown, getAuthCommand, getBumpedIndependentPackages, getBumpedPackageIndependently, getCIName, getCanaryVersion, getCommitSubject, getCurrentGitBranch, getCurrentGitRef, getDefaultConfig, getDependentsOf, getFirstCommit, getGitStatus, getIndependentTag, getLastPackageTag, getLastRepoTag, getLastStableTag, getLastTag, getModifiedReleaseFilePatterns, getPackageCommits, getPackageDependencies, getPackageNewVersion, getPackages, getPackagesOrBumpedPackages, getPackagesToPublishInIndependentMode, getPackagesToPublishInSelectiveMode, getPreid, getReleaseUrl, getRootPackage, getShortCommitSha, getSlackToken, getSlackWebhookUrl, getTwitterCredentials, github, gitlab, hasLernaJson, isAncestor, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, mergeTypes, parseChangelogMarkdown, parseGitRemoteUrl, postPrComment, postReleaseToSlack, postReleaseToTwitter, prComment, providerRelease, providerReleaseSafetyCheck, publish, publishPackage, publishSafetyCheck, pushCommitAndTags, pushTagForce, readPackageJson, readPackages, reconcileFromTag, release, resetRewrittenTagCache, resolveTags, retagAnnotatedLocal, rollbackModifiedFiles, shouldFilterPrereleaseTags, social, socialSafetyCheck, tagExists, topologicalSort, updateLernaVersion, writeChangelogToFile, writeVersion };
+export type { AIConfig, AIPromptTarget, AIProviderName, AISocialConfig, AISystemPromptOverrides, AITargetConfig, BumpConfig, BumpOptions, BumpResult, BumpResultFalsy, BumpResultTruthy, ChangelogConfig, ChangelogInclude, ChangelogOptions, ClaudeCodeProviderOptions, ConfigType, GitProvider, GitlabRelease, GitlabReleaseResponse, HookConfig, HookStep, HookType, MonorepoConfig, OnRewrittenTag, PackageBase, PackageBumpEntry, PackageManager, PostedRelease, PrCommentConfig, PrCommentMode, PrCommentOptions, PrCommentStatus, ProviderReleaseOptions, ProviderReleaseResult, PublishConfig, PublishOptions, PublishResponse, PullRequestInfo, ReadPackage, Reference, ReleaseConfig, ReleaseContext, ReleaseOptions, RelizyConfig, RepoConfig, ResolvedConfig, ResolvedRelizyConfig, ResolvedTags, ResolvedTwitterCredentials, RootPackage, SlackCredentials, SlackOptions, SlackPackageEntry, SlackSocialConfig, SocialConfig, SocialNetworkResult, SocialOptions, SocialResult, Step, TemplatesConfig, TokensConfig, TwitterCredentials, TwitterOptions, TwitterSocialConfig, VersionMode };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { ak as NEW_PACKAGE_MARKER, $ as PR_COMMENT_MARKER, M as buildChangelogBody, a as buildCommentBody, L as buildCompareLink, O as buildContributors, b as bump, ay as capReleaseTypeForZeroMajor, c as changelog, v as checkGitStatusIfDirty, N as collectContributorNames, X as collectPackageBumps, aM as confirmBump, B as createCommitAndTags, J as createGitlabRelease, k as defineConfig, y as detectGitProvider, R as detectPackageManager, _ as detectPullRequest, S as determinePublishTag, aA as determineReleaseType, az as determineSemverChange, at as executeBuildCmd, as as executeFormatCmd, ap as executeHook, q as expandPackagesToBumpWithDependents, ad as extractChangelogSummary, aE as extractVersionFromPackageTag, aP as extractVersionFromTag, x as fetchGitTags, av as filterOutPrivatePackages, Y as findGitHubPR, Z as findGitLabMR, a9 as formatChangelogForSlack, aa as formatPackagesForSlack, ab as formatSlackMessage, an as formatTweetMessage, i as generateChangelog, P as generateMarkDown, V as getAuthCommand, aN as getBumpedIndependentPackages, aL as getBumpedPackageIndependently, ar as getCIName, aQ as getCanaryVersion, F as getCurrentGitBranch, G as getCurrentGitRef, j as getDefaultConfig, o as getDependentsOf, E as getFirstCommit, u as getGitStatus, af as getIndependentTag, aj as getLastPackageTag, ai as getLastRepoTag, ag as getLastStableTag, ah as getLastTag, A as getModifiedReleaseFilePatterns, a5 as getPackageCommits, n as getPackageDependencies, aC as getPackageNewVersion, a4 as getPackages, aw as getPackagesOrBumpedPackages, U as getPackagesToPublishInIndependentMode, T as getPackagesToPublishInSelectiveMode, aJ as getPreid, ae as getReleaseUrl, a2 as getRootPackage, H as getShortCommitSha, a7 as getSlackToken, a8 as getSlackWebhookUrl, am as getTwitterCredentials, I as github, K as gitlab, a6 as hasLernaJson, au as isBumpedPackage, aK as isChangedPreid, aI as isGraduating, ax as isGraduatingToStableBetweenVersion, aq as isInCI, aF as isPrerelease, aH as isPrereleaseReleaseType, aG as isStableReleaseType, aR as isTagVersionCompatibleWithCurrent, l as loadRelizyConfig, m as mergeTypes, Q as parseChangelogMarkdown, z as parseGitRemoteUrl, a0 as postPrComment, ac as postReleaseToSlack, ao as postReleaseToTwitter, p as prComment, e as providerRelease, d as providerReleaseSafetyCheck, g as publish, W as publishPackage, f as publishSafetyCheck, C as pushCommitAndTags, a1 as readPackageJson, a3 as readPackages, r as release, al as resolveTags, D as rollbackModifiedFiles, aO as shouldFilterPrereleaseTags, h as social, s as socialSafetyCheck, t as topologicalSort, aD as updateLernaVersion, w as writeChangelogToFile, aB as writeVersion } from './shared/relizy.-Cr2hO3N.mjs';
+export { as as NEW_PACKAGE_MARKER, a5 as PR_COMMENT_MARKER, S as buildChangelogBody, a as buildCommentBody, R as buildCompareLink, U as buildContributors, b as bump, aG as capReleaseTypeForZeroMajor, c as changelog, v as checkGitStatusIfDirty, T as collectContributorNames, a1 as collectPackageBumps, aU as confirmBump, B as createCommitAndTags, P as createGitlabRelease, k as defineConfig, y as detectGitProvider, X as detectPackageManager, a4 as detectPullRequest, Y as determinePublishTag, aI as determineReleaseType, aH as determineSemverChange, aB as executeBuildCmd, aA as executeFormatCmd, ax as executeHook, q as expandPackagesToBumpWithDependents, al as extractChangelogSummary, aM as extractVersionFromPackageTag, aX as extractVersionFromTag, x as fetchGitTags, aD as filterOutPrivatePackages, a2 as findGitHubPR, a3 as findGitLabMR, K as findReachableCommitBySubject, ah as formatChangelogForSlack, ai as formatPackagesForSlack, aj as formatSlackMessage, av as formatTweetMessage, i as generateChangelog, V as generateMarkDown, $ as getAuthCommand, aV as getBumpedIndependentPackages, aT as getBumpedPackageIndependently, az as getCIName, aY as getCanaryVersion, J as getCommitSubject, F as getCurrentGitBranch, G as getCurrentGitRef, j as getDefaultConfig, o as getDependentsOf, E as getFirstCommit, u as getGitStatus, an as getIndependentTag, ar as getLastPackageTag, aq as getLastRepoTag, ao as getLastStableTag, ap as getLastTag, A as getModifiedReleaseFilePatterns, ab as getPackageCommits, n as getPackageDependencies, aK as getPackageNewVersion, aa as getPackages, aE as getPackagesOrBumpedPackages, _ as getPackagesToPublishInIndependentMode, Z as getPackagesToPublishInSelectiveMode, aR as getPreid, am as getReleaseUrl, a8 as getRootPackage, H as getShortCommitSha, af as getSlackToken, ag as getSlackWebhookUrl, au as getTwitterCredentials, O as github, Q as gitlab, ac as hasLernaJson, I as isAncestor, aC as isBumpedPackage, aS as isChangedPreid, aQ as isGraduating, aF as isGraduatingToStableBetweenVersion, ay as isInCI, aN as isPrerelease, aP as isPrereleaseReleaseType, aO as isStableReleaseType, aZ as isTagVersionCompatibleWithCurrent, l as loadRelizyConfig, m as mergeTypes, W as parseChangelogMarkdown, z as parseGitRemoteUrl, a6 as postPrComment, ak as postReleaseToSlack, aw as postReleaseToTwitter, p as prComment, e as providerRelease, d as providerReleaseSafetyCheck, g as publish, a0 as publishPackage, f as publishSafetyCheck, C as pushCommitAndTags, N as pushTagForce, a7 as readPackageJson, a9 as readPackages, ae as reconcileFromTag, r as release, ad as resetRewrittenTagCache, at as resolveTags, M as retagAnnotatedLocal, D as rollbackModifiedFiles, aW as shouldFilterPrereleaseTags, h as social, s as socialSafetyCheck, L as tagExists, t as topologicalSort, aL as updateLernaVersion, w as writeChangelogToFile, aJ as writeVersion } from './shared/relizy.d-S4lcvu.mjs';
 import '@maz-ui/node';
 import 'node:child_process';
 import 'node:process';