relizy 1.3.0-beta.1 → 1.3.0-beta.3

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 { ag as isInCI, ah 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.w8-5SlcY.mjs';
+import { al as isInCI, am 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.BHnDdNQq.mjs';
 import '@maz-ui/utils';
 import 'c12';
 import 'changelogen';
@@ -124,7 +124,7 @@ program.command("publish").description("Publish packages to registry").option("-
     process.exit(1);
   }
 });
-program.command("provider-release").description("Publish release to git provider (github or gitlab)").option("--from <ref>", "Start commit reference").option("--to <ref>", "End commit reference").option("--token <token>", "Provider token").option("--provider <provider>", "Git provider (github or gitlab)").action(async (options) => {
+program.command("provider-release").description("Publish release to git provider (github or gitlab)").option("--from <ref>", "Start commit reference").option("--to <ref>", "End commit reference").option("--token <token>", "Provider token").option("--provider <provider>", "Git provider (github or gitlab)").option("--ai", "Force-enable AI for release notes").option("--no-ai", "Force-disable AI for release notes").action(async (options) => {
   try {
     await providerRelease({
       token: options.token,
@@ -134,14 +134,15 @@ program.command("provider-release").description("Publish release to git provider
       dryRun: program.opts().dryRun,
       logLevel: program.opts().logLevel,
       configName: program.opts().config,
-      safetyCheck: hasCliFlag("--no-safety-check") ? false : void 0
+      safetyCheck: hasCliFlag("--no-safety-check") ? false : void 0,
+      ai: hasCliFlag("--ai") ? true : hasCliFlag("--no-ai") ? false : void 0
     });
   } catch (error) {
     logger.error("Failed to publish release -", error);
     process.exit(1);
   }
 });
-program.command("social").description("Post release announcements to social media platforms").option("--from <ref>", "Start commit reference").option("--to <ref>", "End commit reference").action(async (options) => {
+program.command("social").description("Post release announcements to social media platforms").option("--from <ref>", "Start commit reference").option("--to <ref>", "End commit reference").option("--ai", "Force-enable AI for social posts").option("--no-ai", "Force-disable AI for social posts").action(async (options) => {
   try {
     await social({
       from: options.from,
@@ -149,7 +150,8 @@ program.command("social").description("Post release announcements to social medi
       dryRun: program.opts().dryRun,
       logLevel: program.opts().logLevel,
       configName: program.opts().config,
-      safetyCheck: hasCliFlag("--no-safety-check") ? false : void 0
+      safetyCheck: hasCliFlag("--no-safety-check") ? false : void 0,
+      ai: hasCliFlag("--ai") ? true : hasCliFlag("--no-ai") ? false : void 0
     });
   } catch {
     process.exit(1);
@@ -168,7 +170,7 @@ program.command("pr-comment").description("Post or re-post a PR comment with rel
     process.exit(1);
   }
 });
-program.command("release").description("Complete release workflow (bump + changelog + commit + tag + push to remote + publish release)").option("--major", "Bump major version").option("--minor", "Bump minor version").option("--patch", "Bump patch version").option("--prerelease", "Bump prerelease version").option("--premajor", "Bump premajor version").option("--preminor", "Bump preminor version").option("--prepatch", "Bump prepatch version").option("--preid <id>", "Prerelease identifier (alpha, beta, rc, etc.)").option("--suffix <suffix>", "Custom suffix for prerelease versions - replace the last .X with .suffix (e.g. 1.0.0-beta.0 -> 1.0.0-beta.suffix)").option("--from <ref>", "Start commit reference").option("--to <ref>", "End commit reference").option("--no-push", "Skip push changes and tags to remote").option("--no-provider-release", "Skip release creation (GitHub/GitLab)").option("--no-publish", "Skip npm publish").option("--registry <url>", "Custom npm registry URL").option("--tag <tag>", "Publish with specific tag (default: latest for stable, next for prerelease)").option("--access <type>", "Package access level (public or restricted)").option("--otp <code>", "One-time password for 2FA").option("--no-verify", "Skip git hooks during commit").option("--format-cmd <cmd>", 'Command to format CHANGELOG files after generation (e.g. "pnpm lint")').option("--build-cmd <cmd>", 'Command to build packages before publish (e.g. "pnpm build")').option("--no-root-changelog", "Skip generation of root changelog file").option("--token <token>", "Git token (github or gitlab)").option("--force", "Bump even if there are no commits").option("--no-clean", "Skip check if the working directory is clean").option("--no-commit", "Skip commit and tag").option("--no-git-tag", "Skip tag creation").option("--no-changelog", "Skip changelog generation files").option("--provider <provider>", "Git provider (github or gitlab)").option("--no-social", "Skip social media posting").option("--no-pr-comment", "Skip PR comment posting").option("--yes", "Skip confirmation prompt about bumping packages").option("--publish-token <token>", 'NPM token (e.g. "123456") - only supported for pnpm and npm').option("--canary", "Publish a canary release from the current commit").option("--include-private", "Include private packages in bump and changelog phases").action(async (options) => {
+program.command("release").description("Complete release workflow (bump + changelog + commit + tag + push to remote + publish release)").option("--major", "Bump major version").option("--minor", "Bump minor version").option("--patch", "Bump patch version").option("--prerelease", "Bump prerelease version").option("--premajor", "Bump premajor version").option("--preminor", "Bump preminor version").option("--prepatch", "Bump prepatch version").option("--preid <id>", "Prerelease identifier (alpha, beta, rc, etc.)").option("--suffix <suffix>", "Custom suffix for prerelease versions - replace the last .X with .suffix (e.g. 1.0.0-beta.0 -> 1.0.0-beta.suffix)").option("--from <ref>", "Start commit reference").option("--to <ref>", "End commit reference").option("--no-push", "Skip push changes and tags to remote").option("--no-provider-release", "Skip release creation (GitHub/GitLab)").option("--no-publish", "Skip npm publish").option("--registry <url>", "Custom npm registry URL").option("--tag <tag>", "Publish with specific tag (default: latest for stable, next for prerelease)").option("--access <type>", "Package access level (public or restricted)").option("--otp <code>", "One-time password for 2FA").option("--no-verify", "Skip git hooks during commit").option("--format-cmd <cmd>", 'Command to format CHANGELOG files after generation (e.g. "pnpm lint")').option("--build-cmd <cmd>", 'Command to build packages before publish (e.g. "pnpm build")').option("--no-root-changelog", "Skip generation of root changelog file").option("--token <token>", "Git token (github or gitlab)").option("--force", "Bump even if there are no commits").option("--no-clean", "Skip check if the working directory is clean").option("--no-commit", "Skip commit and tag").option("--no-git-tag", "Skip tag creation").option("--no-changelog", "Skip changelog generation files").option("--provider <provider>", "Git provider (github or gitlab)").option("--no-social", "Skip social media posting").option("--no-pr-comment", "Skip PR comment posting").option("--yes", "Skip confirmation prompt about bumping packages").option("--publish-token <token>", 'NPM token (e.g. "123456") - only supported for pnpm and npm').option("--canary", "Publish a canary release from the current commit").option("--include-private", "Include private packages in bump and changelog phases").option("--ai", "Force-enable AI for release notes and social posts").option("--no-ai", "Force-disable AI for release notes and social posts").action(async (options) => {
   try {
     await release({
       type: getReleaseType(options),
@@ -203,7 +205,8 @@ program.command("release").description("Complete release workflow (bump + change
       safetyCheck: hasCliFlag("--no-safety-check") ? false : void 0,
       social: hasCliFlag("--no-social") ? false : void 0,
       prComment: hasCliFlag("--no-pr-comment") ? false : void 0,
-      prNumber: program.opts().prNumber
+      prNumber: program.opts().prNumber,
+      ai: hasCliFlag("--ai") ? true : hasCliFlag("--no-ai") ? false : void 0
     });
   } catch (error) {
     logger.error("Failed to release -", error);

package/dist/index.d.mts

@@ -9,7 +9,8 @@ declare function getDefaultConfig(): {
     cwd: string;
     types: NonNullable<RelizyConfig["types"]>;
     templates: {
-        commitMessage: string;
+        commitMessage: string | undefined;
+        commitBody: string | undefined;
         tagMessage: string;
         tagBody: string;
         emptyChangelogContent: string;
@@ -41,6 +42,12 @@ declare function getDefaultConfig(): {
             accessTokenSecret: string | undefined;
         };
         slack: string | undefined;
+        ai: {
+            'claude-code': {
+                apiKey: string | undefined;
+                oauthToken: string | undefined;
+            };
+        };
     };
     scopeMap: {};
     release: Required<ReleaseConfig>;
@@ -56,6 +63,7 @@ declare function getDefaultConfig(): {
         };
     };
     prComment: Required<PrCommentConfig>;
+    ai: AIConfig;
     logLevel: LogLevel;
     safetyCheck: boolean;
 };
@@ -204,6 +212,40 @@ declare function createGitlabRelease({ config, release, dryRun, }: {
 }): Promise<GitlabReleaseResponse>;
 declare function gitlab(options?: Partial<ProviderReleaseOptions>): Promise<PostedRelease[]>;
 
+interface Reference {
+    type: 'hash' | 'issue' | 'pull-request';
+    value: string;
+}
+declare function buildCompareLink({ config, from, to, isFirstCommit }: {
+    config: ResolvedRelizyConfig;
+    from: string;
+    to: string;
+    isFirstCommit: boolean;
+}): string;
+declare function buildChangelogBody({ commits, config, minify }: {
+    commits: GitCommit[];
+    config: ResolvedRelizyConfig;
+    minify?: boolean;
+}): string;
+declare function buildContributors({ commits, config }: {
+    commits: GitCommit[];
+    config: ResolvedRelizyConfig;
+}): Promise<string>;
+declare function generateMarkDown({ commits, config, from, to, isFirstCommit, minify, }: {
+    commits: GitCommit[];
+    config: ResolvedRelizyConfig;
+    from: string;
+    to: string;
+    isFirstCommit: boolean;
+    minify?: boolean;
+}): Promise<string>;
+declare function parseChangelogMarkdown(contents: string): {
+    releases: {
+        version?: string;
+        body: string;
+    }[];
+};
+
 declare function detectPackageManager(cwd?: string): PackageManager;
 declare function determinePublishTag(version: string, configTag?: string): string;
 declare function getPackagesToPublishInSelectiveMode(sortedPackages: PackageBase[], rootVersion: string | undefined): PackageBase[];
@@ -936,6 +978,11 @@ interface ProviderReleaseOptions {
      * Custom suffix for prerelease versions - replace the last .X with .suffix (e.g. 1.0.0-beta.0 -> 1.0.0-beta.suffix)
      */
     suffix?: string;
+    /**
+     * Override AI configuration for this run
+     * true = force-enable AI, false = force-disable AI, undefined = use config
+     */
+    ai?: boolean;
 }
 interface SocialOptions {
     /**
@@ -973,6 +1020,11 @@ interface SocialOptions {
      * @default true
      */
     safetyCheck?: boolean;
+    /**
+     * Override AI configuration for this run
+     * true = force-enable AI, false = force-disable AI, undefined = use config
+     */
+    ai?: boolean;
 }
 type PublishConfig = ChangelogConfig$1['publish'] & {
     /**
@@ -1157,6 +1209,11 @@ interface ReleaseOptions extends ReleaseConfig, BumpConfig, ChangelogConfig, Pub
      * @default false
      */
     includePrivates?: boolean;
+    /**
+     * Override AI configuration for this run
+     * true = force-enable AI, false = force-disable AI, undefined = use config
+     */
+    ai?: boolean;
 }
 interface TwitterCredentials {
     /**
@@ -1237,6 +1294,86 @@ interface SlackSocialConfig {
      */
     credentials?: SlackCredentials;
 }
+type AIProviderName = 'claude-code';
+interface ClaudeCodeProviderOptions {
+    /**
+     * Anthropic API key.
+     * Fallback env: `RELIZY_ANTHROPIC_API_KEY`, `ANTHROPIC_API_KEY`.
+     */
+    apiKey?: string;
+    /**
+     * Claude Code OAuth token.
+     * Fallback env: `RELIZY_CLAUDE_CODE_OAUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN`.
+     */
+    oauthToken?: string;
+    /**
+     * Model id or alias (e.g. `haiku`, `sonnet`, `opus`, or a versioned id).
+     * @default 'haiku'
+     */
+    model?: string;
+}
+type AIPromptTarget = 'providerRelease' | 'twitter' | 'slack';
+type AISystemPromptOverrides = Partial<Record<AIPromptTarget, string>>;
+interface AITargetConfig {
+    /**
+     * Enable AI for this target
+     * @default false
+     */
+    enabled?: boolean;
+}
+interface AISocialConfig {
+    /**
+     * Twitter-specific AI activation
+     */
+    twitter?: AITargetConfig;
+    /**
+     * Slack-specific AI activation
+     */
+    slack?: AITargetConfig;
+}
+interface AIConfig {
+    /**
+     * AI provider name
+     * @default 'claude-code'
+     */
+    provider?: AIProviderName;
+    /**
+     * Provider-specific options, keyed by provider name.
+     */
+    providers?: {
+        'claude-code'?: ClaudeCodeProviderOptions;
+    };
+    /**
+     * Output language (ISO 639-1 code or plain English name).
+     * @default 'en'
+     */
+    language?: string;
+    /**
+     * Behavior when the provider call fails.
+     * - `raw`: fall back to the unmodified changelog body.
+     * - `fail`: re-throw the error.
+     * @default 'raw'
+     */
+    fallback?: 'raw' | 'fail';
+    /**
+     * Extra directives appended to every built-in system prompt.
+     * @example 'Always use emojis in the changelog'
+     */
+    extraGuidelines?: string;
+    /**
+     * Full replacement of the built-in system prompts.
+     * When set, the extraGuidelines and base prompts are ignored for that target.
+     */
+    systemPromptOverrides?: AISystemPromptOverrides;
+    /**
+     * Enable AI rewriting for GitHub/GitLab release notes.
+     */
+    providerRelease?: AITargetConfig;
+    /**
+     * Enable AI rewriting for social media posts.
+     */
+    social?: AISocialConfig;
+}
 interface SocialConfig {
     /**
      * Twitter configuration
@@ -1338,19 +1475,43 @@ interface SlackOptions {
 }
 interface TemplatesConfig {
     /**
-     * Commit message template
+     * Commit message template (title).
+     *
+     * Default in `unified`/`selective` modes: `'chore(release): bump version to {{newVersion}}'`.
+     * Default in `independent` mode (when not customized): `'chore(release): bump {{packageCount}} packages'`.
+     *
+     * Available variables:
+     * - `{{newVersion}}` — in `independent` mode, comma-separated list of bumped `name@version` (legacy behavior); otherwise the new version.
+     * - `{{packageCount}}` — number of bumped packages.
+     * - `{{packageNames}}` — comma-separated list of bumped package names.
+     * - `{{packageList}}` — comma-separated list of bumped `name@version`.
+     * - `{{rootVersion}}` — version from the root `package.json`.
      */
     commitMessage?: string;
+    /**
+     * Commit message body template. When defined, it is passed as the commit body.
+     *
+     * Default in `unified`/`selective` modes: `undefined` (no body).
+     * Default in `independent` mode (when `commitMessage` and `commitBody` are not customized): `'{{packageList}}'`.
+     *
+     * Same variables as `commitMessage`.
+     */
+    commitBody?: string;
     /**
      * Tag message template
+     * @default 'Bump version to {{newVersion}}'
+     * Available variables: {{newVersion}}
      */
     tagMessage?: string;
     /**
      * Not used with "independent" version mode
+     * @default 'v{{newVersion}}'
+     * Available variables: {{newVersion}}
      */
     tagBody?: string;
     /**
      * Empty changelog content
+     * @default 'No relevant changes for this release'
      */
     emptyChangelogContent?: string;
     /**
@@ -1428,6 +1589,15 @@ interface TokensConfig {
      * Environment variables: SLACK_TOKEN, RELIZY_SLACK_TOKEN
      */
     slack?: string;
+    /**
+     * AI provider credentials
+     */
+    ai?: {
+        'claude-code'?: {
+            apiKey?: string;
+            oauthToken?: string;
+        };
+    };
 }
 /**
  * Hooks configuration
@@ -1508,6 +1678,10 @@ interface RelizyConfig extends Partial<Omit<ChangelogConfig$1, 'output' | 'templ
      * API tokens configuration
      */
     tokens?: TokensConfig;
+    /**
+     * AI-powered changelog and release notes configuration
+     */
+    ai?: AIConfig;
     /**
      * Hooks config
      */
@@ -1557,7 +1731,7 @@ declare function prComment(options?: PrCommentOptions): Promise<boolean>;
 declare function providerReleaseSafetyCheck({ config, provider }: {
     config: ResolvedRelizyConfig;
     provider?: GitProvider | null;
-}): void;
+}): Promise<void>;
 declare function providerRelease(options?: Partial<ProviderReleaseOptions>): Promise<ProviderReleaseResult>;
 
 declare function publishSafetyCheck({ config }: {
@@ -1574,5 +1748,5 @@ declare function socialSafetyCheck({ config }: {
 }): Promise<void>;
 declare function social(options?: Partial<SocialOptions>): Promise<SocialResult>;
 
-export { NEW_PACKAGE_MARKER, PR_COMMENT_MARKER, buildCommentBody, bump, capReleaseTypeForZeroMajor, changelog, checkGitStatusIfDirty, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, formatChangelogForSlack, formatSlackMessage, formatTweetMessage, generateChangelog, 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, getTwitterCredentials, github, gitlab, hasLernaJson, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, 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 { BumpConfig, BumpOptions, BumpResult, BumpResultFalsy, BumpResultTruthy, ChangelogConfig, ChangelogOptions, ConfigType, GitProvider, GitlabRelease, GitlabReleaseResponse, HookConfig, HookStep, HookType, MonorepoConfig, PackageBase, PackageManager, PostedRelease, PrCommentConfig, PrCommentMode, PrCommentOptions, PrCommentStatus, ProviderReleaseOptions, ProviderReleaseResult, PublishConfig, PublishOptions, PublishResponse, PullRequestInfo, ReadPackage, ReleaseConfig, ReleaseContext, ReleaseOptions, RelizyConfig, RepoConfig, ResolvedConfig, ResolvedRelizyConfig, ResolvedTags, ResolvedTwitterCredentials, RootPackage, SlackCredentials, SlackOptions, 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, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, formatChangelogForSlack, 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, getTwitterCredentials, github, gitlab, hasLernaJson, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, 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, 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, SlackSocialConfig, SocialConfig, SocialNetworkResult, SocialOptions, SocialResult, Step, TemplatesConfig, TokensConfig, TwitterCredentials, TwitterOptions, TwitterSocialConfig, VersionMode };

package/dist/index.d.ts

@@ -9,7 +9,8 @@ declare function getDefaultConfig(): {
     cwd: string;
     types: NonNullable<RelizyConfig["types"]>;
     templates: {
-        commitMessage: string;
+        commitMessage: string | undefined;
+        commitBody: string | undefined;
         tagMessage: string;
         tagBody: string;
         emptyChangelogContent: string;
@@ -41,6 +42,12 @@ declare function getDefaultConfig(): {
             accessTokenSecret: string | undefined;
         };
         slack: string | undefined;
+        ai: {
+            'claude-code': {
+                apiKey: string | undefined;
+                oauthToken: string | undefined;
+            };
+        };
     };
     scopeMap: {};
     release: Required<ReleaseConfig>;
@@ -56,6 +63,7 @@ declare function getDefaultConfig(): {
         };
     };
     prComment: Required<PrCommentConfig>;
+    ai: AIConfig;
     logLevel: LogLevel;
     safetyCheck: boolean;
 };
@@ -204,6 +212,40 @@ declare function createGitlabRelease({ config, release, dryRun, }: {
 }): Promise<GitlabReleaseResponse>;
 declare function gitlab(options?: Partial<ProviderReleaseOptions>): Promise<PostedRelease[]>;
 
+interface Reference {
+    type: 'hash' | 'issue' | 'pull-request';
+    value: string;
+}
+declare function buildCompareLink({ config, from, to, isFirstCommit }: {
+    config: ResolvedRelizyConfig;
+    from: string;
+    to: string;
+    isFirstCommit: boolean;
+}): string;
+declare function buildChangelogBody({ commits, config, minify }: {
+    commits: GitCommit[];
+    config: ResolvedRelizyConfig;
+    minify?: boolean;
+}): string;
+declare function buildContributors({ commits, config }: {
+    commits: GitCommit[];
+    config: ResolvedRelizyConfig;
+}): Promise<string>;
+declare function generateMarkDown({ commits, config, from, to, isFirstCommit, minify, }: {
+    commits: GitCommit[];
+    config: ResolvedRelizyConfig;
+    from: string;
+    to: string;
+    isFirstCommit: boolean;
+    minify?: boolean;
+}): Promise<string>;
+declare function parseChangelogMarkdown(contents: string): {
+    releases: {
+        version?: string;
+        body: string;
+    }[];
+};
+
 declare function detectPackageManager(cwd?: string): PackageManager;
 declare function determinePublishTag(version: string, configTag?: string): string;
 declare function getPackagesToPublishInSelectiveMode(sortedPackages: PackageBase[], rootVersion: string | undefined): PackageBase[];
@@ -936,6 +978,11 @@ interface ProviderReleaseOptions {
      * Custom suffix for prerelease versions - replace the last .X with .suffix (e.g. 1.0.0-beta.0 -> 1.0.0-beta.suffix)
      */
     suffix?: string;
+    /**
+     * Override AI configuration for this run
+     * true = force-enable AI, false = force-disable AI, undefined = use config
+     */
+    ai?: boolean;
 }
 interface SocialOptions {
     /**
@@ -973,6 +1020,11 @@ interface SocialOptions {
      * @default true
      */
     safetyCheck?: boolean;
+    /**
+     * Override AI configuration for this run
+     * true = force-enable AI, false = force-disable AI, undefined = use config
+     */
+    ai?: boolean;
 }
 type PublishConfig = ChangelogConfig$1['publish'] & {
     /**
@@ -1157,6 +1209,11 @@ interface ReleaseOptions extends ReleaseConfig, BumpConfig, ChangelogConfig, Pub
      * @default false
      */
     includePrivates?: boolean;
+    /**
+     * Override AI configuration for this run
+     * true = force-enable AI, false = force-disable AI, undefined = use config
+     */
+    ai?: boolean;
 }
 interface TwitterCredentials {
     /**
@@ -1237,6 +1294,86 @@ interface SlackSocialConfig {
      */
     credentials?: SlackCredentials;
 }
+type AIProviderName = 'claude-code';
+interface ClaudeCodeProviderOptions {
+    /**
+     * Anthropic API key.
+     * Fallback env: `RELIZY_ANTHROPIC_API_KEY`, `ANTHROPIC_API_KEY`.
+     */
+    apiKey?: string;
+    /**
+     * Claude Code OAuth token.
+     * Fallback env: `RELIZY_CLAUDE_CODE_OAUTH_TOKEN`, `CLAUDE_CODE_OAUTH_TOKEN`.
+     */
+    oauthToken?: string;
+    /**
+     * Model id or alias (e.g. `haiku`, `sonnet`, `opus`, or a versioned id).
+     * @default 'haiku'
+     */
+    model?: string;
+}
+type AIPromptTarget = 'providerRelease' | 'twitter' | 'slack';
+type AISystemPromptOverrides = Partial<Record<AIPromptTarget, string>>;
+interface AITargetConfig {
+    /**
+     * Enable AI for this target
+     * @default false
+     */
+    enabled?: boolean;
+}
+interface AISocialConfig {
+    /**
+     * Twitter-specific AI activation
+     */
+    twitter?: AITargetConfig;
+    /**
+     * Slack-specific AI activation
+     */
+    slack?: AITargetConfig;
+}
+interface AIConfig {
+    /**
+     * AI provider name
+     * @default 'claude-code'
+     */
+    provider?: AIProviderName;
+    /**
+     * Provider-specific options, keyed by provider name.
+     */
+    providers?: {
+        'claude-code'?: ClaudeCodeProviderOptions;
+    };
+    /**
+     * Output language (ISO 639-1 code or plain English name).
+     * @default 'en'
+     */
+    language?: string;
+    /**
+     * Behavior when the provider call fails.
+     * - `raw`: fall back to the unmodified changelog body.
+     * - `fail`: re-throw the error.
+     * @default 'raw'
+     */
+    fallback?: 'raw' | 'fail';
+    /**
+     * Extra directives appended to every built-in system prompt.
+     * @example 'Always use emojis in the changelog'
+     */
+    extraGuidelines?: string;
+    /**
+     * Full replacement of the built-in system prompts.
+     * When set, the extraGuidelines and base prompts are ignored for that target.
+     */
+    systemPromptOverrides?: AISystemPromptOverrides;
+    /**
+     * Enable AI rewriting for GitHub/GitLab release notes.
+     */
+    providerRelease?: AITargetConfig;
+    /**
+     * Enable AI rewriting for social media posts.
+     */
+    social?: AISocialConfig;
+}
 interface SocialConfig {
     /**
      * Twitter configuration
@@ -1338,19 +1475,43 @@ interface SlackOptions {
 }
 interface TemplatesConfig {
     /**
-     * Commit message template
+     * Commit message template (title).
+     *
+     * Default in `unified`/`selective` modes: `'chore(release): bump version to {{newVersion}}'`.
+     * Default in `independent` mode (when not customized): `'chore(release): bump {{packageCount}} packages'`.
+     *
+     * Available variables:
+     * - `{{newVersion}}` — in `independent` mode, comma-separated list of bumped `name@version` (legacy behavior); otherwise the new version.
+     * - `{{packageCount}}` — number of bumped packages.
+     * - `{{packageNames}}` — comma-separated list of bumped package names.
+     * - `{{packageList}}` — comma-separated list of bumped `name@version`.
+     * - `{{rootVersion}}` — version from the root `package.json`.
      */
     commitMessage?: string;
+    /**
+     * Commit message body template. When defined, it is passed as the commit body.
+     *
+     * Default in `unified`/`selective` modes: `undefined` (no body).
+     * Default in `independent` mode (when `commitMessage` and `commitBody` are not customized): `'{{packageList}}'`.
+     *
+     * Same variables as `commitMessage`.
+     */
+    commitBody?: string;
     /**
      * Tag message template
+     * @default 'Bump version to {{newVersion}}'
+     * Available variables: {{newVersion}}
      */
     tagMessage?: string;
     /**
      * Not used with "independent" version mode
+     * @default 'v{{newVersion}}'
+     * Available variables: {{newVersion}}
      */
     tagBody?: string;
     /**
      * Empty changelog content
+     * @default 'No relevant changes for this release'
      */
     emptyChangelogContent?: string;
     /**
@@ -1428,6 +1589,15 @@ interface TokensConfig {
      * Environment variables: SLACK_TOKEN, RELIZY_SLACK_TOKEN
      */
     slack?: string;
+    /**
+     * AI provider credentials
+     */
+    ai?: {
+        'claude-code'?: {
+            apiKey?: string;
+            oauthToken?: string;
+        };
+    };
 }
 /**
  * Hooks configuration
@@ -1508,6 +1678,10 @@ interface RelizyConfig extends Partial<Omit<ChangelogConfig$1, 'output' | 'templ
      * API tokens configuration
      */
     tokens?: TokensConfig;
+    /**
+     * AI-powered changelog and release notes configuration
+     */
+    ai?: AIConfig;
     /**
      * Hooks config
      */
@@ -1557,7 +1731,7 @@ declare function prComment(options?: PrCommentOptions): Promise<boolean>;
 declare function providerReleaseSafetyCheck({ config, provider }: {
     config: ResolvedRelizyConfig;
     provider?: GitProvider | null;
-}): void;
+}): Promise<void>;
 declare function providerRelease(options?: Partial<ProviderReleaseOptions>): Promise<ProviderReleaseResult>;
 
 declare function publishSafetyCheck({ config }: {
@@ -1574,5 +1748,5 @@ declare function socialSafetyCheck({ config }: {
 }): Promise<void>;
 declare function social(options?: Partial<SocialOptions>): Promise<SocialResult>;
 
-export { NEW_PACKAGE_MARKER, PR_COMMENT_MARKER, buildCommentBody, bump, capReleaseTypeForZeroMajor, changelog, checkGitStatusIfDirty, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, formatChangelogForSlack, formatSlackMessage, formatTweetMessage, generateChangelog, 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, getTwitterCredentials, github, gitlab, hasLernaJson, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, 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 { BumpConfig, BumpOptions, BumpResult, BumpResultFalsy, BumpResultTruthy, ChangelogConfig, ChangelogOptions, ConfigType, GitProvider, GitlabRelease, GitlabReleaseResponse, HookConfig, HookStep, HookType, MonorepoConfig, PackageBase, PackageManager, PostedRelease, PrCommentConfig, PrCommentMode, PrCommentOptions, PrCommentStatus, ProviderReleaseOptions, ProviderReleaseResult, PublishConfig, PublishOptions, PublishResponse, PullRequestInfo, ReadPackage, ReleaseConfig, ReleaseContext, ReleaseOptions, RelizyConfig, RepoConfig, ResolvedConfig, ResolvedRelizyConfig, ResolvedTags, ResolvedTwitterCredentials, RootPackage, SlackCredentials, SlackOptions, 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, confirmBump, createCommitAndTags, createGitlabRelease, defineConfig, detectGitProvider, detectPackageManager, detectPullRequest, determinePublishTag, determineReleaseType, determineSemverChange, executeBuildCmd, executeFormatCmd, executeHook, expandPackagesToBumpWithDependents, extractChangelogSummary, extractVersionFromPackageTag, extractVersionFromTag, fetchGitTags, filterOutPrivatePackages, findGitHubPR, findGitLabMR, formatChangelogForSlack, 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, getTwitterCredentials, github, gitlab, hasLernaJson, isBumpedPackage, isChangedPreid, isGraduating, isGraduatingToStableBetweenVersion, isInCI, isPrerelease, isPrereleaseReleaseType, isStableReleaseType, isTagVersionCompatibleWithCurrent, loadRelizyConfig, 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, 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, SlackSocialConfig, SocialConfig, SocialNetworkResult, SocialOptions, SocialResult, Step, TemplatesConfig, TokensConfig, TwitterCredentials, TwitterOptions, TwitterSocialConfig, VersionMode };

package/dist/index.mjs

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