@fern-api/fern-api-dev 4.65.3-6-gfc20f801ab1 → 4.66.0

package/cli.cjs

@@ -58630,6 +58630,24 @@ var init_ClonedRepository = __esm({
         const result = await this.git.raw(["rev-parse", `${commitSha}^{tree}`]);
         return result.trim();
       }
+      /**
+       * Returns true if the working tree has uncommitted changes (staged or unstaged).
+       */
+      async hasChanges() {
+        await this.git.cwd(this.clonePath);
+        const status = await this.git.status();
+        return !status.isClean();
+      }
+      /**
+       * Compares the tree hash of HEAD against a ref (e.g. `origin/main`).
+       * Returns true if the trees are identical (no content difference).
+       * Useful for detecting no-diff after committing — if trees match, the commit is a no-op.
+       */
+      async treeHashEquals(ref2) {
+        const headTree = await this.getHeadTreeHash();
+        const refTree = await this.getCommitTreeHash(ref2);
+        return headTree === refTree;
+      }
       // This tag is a moving pointer (fern-generation-base--<generator>) that tracks the latest
       // clean generation SHA. --force is required because: (1) the tag is intentionally overwritten
       // each generation, and (2) --force-with-lease doesn't work for tags since git tag -f overwrites
@@ -357485,6 +357503,9 @@ var require_GithubStep = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.GithubStep = void 0;
+    exports2.enrichPrBodyForAutomation = enrichPrBodyForAutomation;
+    exports2.shouldEnableAutomerge = shouldEnableAutomerge;
+    exports2.resolveBranchAction = resolveBranchAction;
     var core_utils_1 = (init_lib4(), __toCommonJS(lib_exports));
     var github_1 = (init_lib7(), __toCommonJS(lib_exports3));
     var rest_1 = (init_dist_src9(), __toCommonJS(dist_src_exports));
@@ -357541,26 +357562,39 @@ var require_GithubStep = __commonJS({
         const baseBranch = this.config.branch ?? await repository.getDefaultBranch();
         const octokit = new rest_1.Octokit({ auth: this.config.token });
         const { owner, repo } = (0, github_1.parseRepository)(this.config.uri);
-        const existingPR = await (0, findExistingUpdatablePR_1.findExistingUpdatablePR)(octokit, owner, repo, baseBranch, this.logger);
         let prBranch;
         let isUpdatingExistingPR = false;
         let generationBaseSha;
+        let existingPR;
+        if (!this.config.automationMode) {
+          existingPR = await (0, findExistingUpdatablePR_1.findExistingUpdatablePR)(octokit, owner, repo, baseBranch, this.logger);
+        }
         if (existingPR != null) {
           this.logger.info(`Found existing updatable PR #${existingPR.number}, will update branch ${existingPR.headBranch}`);
           prBranch = existingPR.headBranch;
           isUpdatingExistingPR = true;
-          if (skipCommit) {
-            generationBaseSha = await (0, createReplayBranch_1.createReplayBranch)(repository, prBranch, this.config.commitMessage, replayConflictInfo, this.logger);
-          } else {
-            await repository.checkoutRemoteBranch(prBranch);
-          }
         } else {
-          this.logger.debug(`No existing updatable PR found, creating new branch ${newPrBranch}`);
+          this.logger.debug(this.config.automationMode ? `Automation mode: creating new branch ${newPrBranch}` : `No existing updatable PR found, creating new branch ${newPrBranch}`);
           prBranch = newPrBranch;
-          if (skipCommit) {
+        }
+        const branchAction = resolveBranchAction({
+          automationMode: this.config.automationMode === true,
+          skipCommit,
+          existingPR
+        });
+        switch (branchAction) {
+          case "replay-branch":
             generationBaseSha = await (0, createReplayBranch_1.createReplayBranch)(repository, prBranch, this.config.commitMessage, replayConflictInfo, this.logger);
-          } else {
-            await repository.checkout(prBranch);
+            break;
+          case "create-from-head":
+            await repository.createBranchFromHead(prBranch);
+            break;
+          case "checkout-remote":
+            await repository.checkoutRemoteBranch(prBranch);
+            break;
+          default: {
+            const _exhaustive = branchAction;
+            throw new Error(`Unexpected branch action: ${String(_exhaustive)}`);
           }
         }
         if (!skipCommit) {
@@ -357570,6 +357604,13 @@ var require_GithubStep = __commonJS({
           await repository.commitAllChanges(finalCommitMessage2);
           this.logger.debug(`Committed changes to local copy of GitHub repository at ${this.outputDir}`);
         }
+        if (this.config.automationMode) {
+          const noDiff = await repository.treeHashEquals(`origin/${baseBranch}`);
+          if (noDiff) {
+            this.logger.info("No changes detected after generation \u2014 skipping PR creation");
+            return { executed: true, success: true, skippedNoDiff: true };
+          }
+        }
         const result = {
           executed: true,
           success: true,
@@ -357599,7 +357640,8 @@ var require_GithubStep = __commonJS({
         const finalCommitMessage = this.config.commitMessage ?? "SDK Generation";
         const { prTitle, prBody } = (0, parseCommitMessage_1.parseCommitMessageForPR)(finalCommitMessage, this.config.changelogEntry, this.config.prDescription, this.config.versionBumpReason);
         const replaySection = (0, replay_summary_1.formatReplayPrBody)(replayResult, { branchName: prBranch, repoUri: this.config.uri });
-        const enrichedBody = replaySection != null ? prBody + "\n\n---\n\n" + replaySection : prBody;
+        let enrichedBody = replaySection != null ? prBody + "\n\n---\n\n" + replaySection : prBody;
+        enrichedBody = enrichPrBodyForAutomation(enrichedBody, this.config);
         if (isUpdatingExistingPR && existingPR != null) {
           this.logger.info(`Updated existing pull request: ${existingPR.htmlUrl}`);
           result.prUrl = existingPR.htmlUrl;
@@ -357630,6 +357672,20 @@ var require_GithubStep = __commonJS({
             this.logger.info(`Created pull request: ${pullRequest.html_url}`);
             result.prUrl = pullRequest.html_url;
             result.prNumber = pullRequest.number;
+            if (shouldEnableAutomerge(this.config) && pullRequest.node_id) {
+              try {
+                await octokit.graphql(`mutation($pullRequestId: ID!) {
+                                enablePullRequestAutoMerge(input: {
+                                    pullRequestId: $pullRequestId,
+                                    mergeMethod: SQUASH
+                                }) { clientMutationId }
+                            }`, { pullRequestId: pullRequest.node_id });
+                this.logger.info(`Enabled automerge on PR #${pullRequest.number}`);
+                result.autoMergeEnabled = true;
+              } catch (autoMergeError) {
+                this.logger.warn(`Could not enable automerge: ${(0, core_utils_1.extractErrorMessage)(autoMergeError)}`);
+              }
+            }
           } catch (error50) {
             const message = (0, core_utils_1.extractErrorMessage)(error50);
             if (message.includes("A pull request already exists for")) {
@@ -357642,6 +357698,7 @@ var require_GithubStep = __commonJS({
         return result;
       }
       async executePushMode(repository) {
+        const baseBranch = this.config.branch ?? await repository.getDefaultBranch();
         if (this.config.branch != null) {
           this.logger.debug(`Checking out branch ${this.config.branch}`);
           await repository.checkout(this.config.branch);
@@ -357651,6 +357708,13 @@ var require_GithubStep = __commonJS({
         const finalCommitMessage = this.config.commitMessage ?? "SDK Generation";
         await repository.commitAllChanges(finalCommitMessage);
         this.logger.debug(`Committed changes to local copy of GitHub repository at ${this.outputDir}`);
+        if (this.config.automationMode) {
+          const noDiff = await repository.treeHashEquals(`origin/${baseBranch}`);
+          if (noDiff) {
+            this.logger.info("No changes detected after generation \u2014 skipping push");
+            return { executed: true, success: true, skippedNoDiff: true };
+          }
+        }
         const result = {
           executed: true,
           success: true
@@ -357696,6 +357760,38 @@ var require_GithubStep = __commonJS({
       }
     };
     exports2.GithubStep = GithubStep;
+    function enrichPrBodyForAutomation(body, config5) {
+      if (!config5.automationMode) {
+        return body;
+      }
+      let result = body;
+      if (config5.hasBreakingChanges && config5.breakingChangesSummary) {
+        result += "\n\n---\n\n## \u26A0\uFE0F Breaking Changes\n\nThis release contains breaking changes that require manual review:\n\n" + config5.breakingChangesSummary;
+      }
+      if (config5.runId) {
+        result += `
+
+---
+
+_Fern Run ID: \`${config5.runId}\`_`;
+      }
+      return result;
+    }
+    function shouldEnableAutomerge(config5) {
+      return config5.automationMode === true && config5.autoMerge === true && config5.hasBreakingChanges !== true;
+    }
+    function resolveBranchAction({ automationMode, skipCommit, existingPR }) {
+      if (skipCommit) {
+        return "replay-branch";
+      }
+      if (automationMode) {
+        return "create-from-head";
+      }
+      if (existingPR != null) {
+        return "checkout-remote";
+      }
+      return "create-from-head";
+    }
   }
 });
 
@@ -521452,6 +521548,7 @@ __export(generators_yml_exports, {
   RemoveDiscriminantsFromSchemas: () => RemoveDiscriminantsFromSchemas,
   UnionSettingsSchema: () => UnionSettingsSchema,
   ai: () => ai_exports,
+  automation: () => automation_exports,
   fernDefinition: () => fernDefinition_exports,
   generators: () => generators_exports,
   getPackageName: () => getPackageName,
@@ -521467,6 +521564,7 @@ __export(generators_yml_exports, {
   isRawProtobufAPIDefinitionSchema: () => isRawProtobufAPIDefinitionSchema,
   license: () => license_exports,
   replay: () => replay_exports,
+  resolveAutomationConfig: () => resolveAutomationConfig,
   reviewers: () => reviewers_exports,
   serialization: () => serialization_exports4
 });
@@ -521530,6 +521628,22 @@ function isRawProtobufAPIDefinitionSchema(rawApiConfiguration) {
   return typeof rawApiConfiguration !== "string" && "proto" in rawApiConfiguration;
 }
 
+// ../configuration/lib/generators-yml/resolveAutomationConfig.js
+var DEFAULT_AUTOMATION_CONFIG = {
+  generate: true,
+  upgrade: true,
+  preview: true,
+  verify: true
+};
+function resolveAutomationConfig({ rootAutomation, groupAutomation, generatorAutomation }) {
+  return {
+    generate: generatorAutomation?.generate ?? groupAutomation?.generate ?? rootAutomation?.generate ?? DEFAULT_AUTOMATION_CONFIG.generate,
+    upgrade: generatorAutomation?.upgrade ?? groupAutomation?.upgrade ?? rootAutomation?.upgrade ?? DEFAULT_AUTOMATION_CONFIG.upgrade,
+    preview: generatorAutomation?.preview ?? groupAutomation?.preview ?? rootAutomation?.preview ?? DEFAULT_AUTOMATION_CONFIG.preview,
+    verify: generatorAutomation?.verify ?? groupAutomation?.verify ?? rootAutomation?.verify ?? DEFAULT_AUTOMATION_CONFIG.verify
+  };
+}
+
 // ../configuration/lib/generators-yml/schemas/api/resources/ai/index.js
 var ai_exports = {};
 __export(ai_exports, {
@@ -521543,6 +521657,9 @@ var ModelProvider = {
   Bedrock: "bedrock"
 };
 
+// ../configuration/lib/generators-yml/schemas/api/resources/automation/index.js
+var automation_exports = {};
+
 // ../configuration/lib/generators-yml/schemas/api/resources/fernDefinition/index.js
 var fernDefinition_exports = {};
 __export(fernDefinition_exports, {
@@ -521726,6 +521843,7 @@ __export(serialization_exports4, {
   ApiDefinitionWithOverridesSchema: () => ApiDefinitionWithOverridesSchema,
   AsyncApiSettingsSchema: () => AsyncApiSettingsSchema,
   AsyncApiSpecSchema: () => AsyncApiSpecSchema,
+  AutomationSchema: () => AutomationSchema,
   BaseApiSettingsSchema: () => BaseApiSettingsSchema,
   BaseGeneratorInvocationSchema: () => BaseGeneratorInvocationSchema,
   CoerceConstsTo: () => CoerceConstsTo2,
@@ -521799,6 +521917,7 @@ __export(serialization_exports4, {
   WhitelabelConfigurationSchema: () => WhitelabelConfigurationSchema,
   WhitelabelGithubConfigurationSchema: () => WhitelabelGithubConfigurationSchema,
   ai: () => ai_exports2,
+  automation: () => automation_exports2,
   fernDefinition: () => fernDefinition_exports2,
   generators: () => generators_exports2,
   group: () => group_exports2,
@@ -523238,6 +523357,20 @@ var AiServicesSchema = schemas_exports8.object({
   model: ModelName
 });
 
+// ../configuration/lib/generators-yml/schemas/serialization/resources/automation/index.js
+var automation_exports2 = {};
+__export(automation_exports2, {
+  AutomationSchema: () => AutomationSchema
+});
+
+// ../configuration/lib/generators-yml/schemas/serialization/resources/automation/types/AutomationSchema.js
+var AutomationSchema = schemas_exports8.object({
+  generate: schemas_exports8.boolean().optional(),
+  upgrade: schemas_exports8.boolean().optional(),
+  preview: schemas_exports8.boolean().optional(),
+  verify: schemas_exports8.boolean().optional()
+});
+
 // ../configuration/lib/generators-yml/schemas/serialization/resources/fernDefinition/index.js
 var fernDefinition_exports2 = {};
 __export(fernDefinition_exports2, {
@@ -524198,7 +524331,8 @@ var BaseGeneratorInvocationSchema = schemas_exports8.object({
   api: GeneratorApiSettingsSchema.optional(),
   "disable-examples": schemas_exports8.boolean().optional(),
   "publish-metadata": GeneratorPublishMetadataSchema.optional(),
-  autorelease: schemas_exports8.boolean().optional()
+  autorelease: schemas_exports8.boolean().optional(),
+  automation: AutomationSchema.optional()
 });
 
 // ../configuration/lib/generators-yml/schemas/serialization/resources/group/types/CustomGeneratorInvocationSchema.js
@@ -524219,7 +524353,8 @@ var GeneratorGroupSchema = schemas_exports8.object({
   audiences: schemas_exports8.list(schemas_exports8.string()).optional(),
   generators: schemas_exports8.list(GeneratorInvocationSchema),
   metadata: OutputMetadataSchema.optional(),
-  reviewers: ReviewersSchema.optional()
+  reviewers: ReviewersSchema.optional(),
+  automation: AutomationSchema.optional()
 });
 
 // ../configuration/lib/generators-yml/schemas/serialization/resources/replay/types/ReplayConfigSchema.js
@@ -524298,6 +524433,7 @@ var GeneratorsConfigurationSchema = schemas_exports8.object({
   replay: ReplayConfigSchema.optional(),
   ai: AiServicesSchema.optional(),
   autorelease: schemas_exports8.boolean().optional(),
+  automation: AutomationSchema.optional(),
   openapi: GeneratorsOpenApiSchema.optional(),
   "openapi-overrides": schemas_exports8.string().optional(),
   "spec-origin": schemas_exports8.string().optional(),
@@ -557180,6 +557316,7 @@ async function convertGeneratorsConfiguration({ absolutePathToGeneratorsConfigur
       group,
       maybeTopLevelMetadata,
       maybeTopLevelReviewers: rawGeneratorsConfiguration.reviewers,
+      maybeRootAutomation: rawGeneratorsConfiguration.automation,
       readme,
       context: context3
     }))) : [],
@@ -557545,7 +557682,7 @@ async function parseAPIConfiguration(rawGeneratorsConfiguration) {
     definitions: await parseAPIConfigurationToApiLocations(apiConfiguration, rawGeneratorsConfiguration, emptySettings)
   };
 }
-async function convertGroup({ absolutePathToGeneratorsConfiguration, groupName, group, maybeTopLevelMetadata, maybeTopLevelReviewers, readme, context: context3 }) {
+async function convertGroup({ absolutePathToGeneratorsConfiguration, groupName, group, maybeTopLevelMetadata, maybeTopLevelReviewers, maybeRootAutomation, readme, context: context3 }) {
   const maybeGroupLevelMetadata = getOutputMetadata(group.metadata);
   return {
     groupName,
@@ -557558,6 +557695,8 @@ async function convertGroup({ absolutePathToGeneratorsConfiguration, groupName,
       maybeGroupLevelMetadata,
       maybeTopLevelReviewers,
       maybeGroupLevelReviewers: group.reviewers,
+      maybeRootAutomation,
+      maybeGroupAutomation: group.automation,
       readme,
       context: context3
     })))
@@ -557579,10 +557718,15 @@ function getGeneratorNameAndImage(generator, context3) {
     containerImage: void 0
   };
 }
-async function convertGenerator({ absolutePathToGeneratorsConfiguration, generator, maybeGroupLevelMetadata, maybeTopLevelMetadata, maybeGroupLevelReviewers, maybeTopLevelReviewers, readme, context: context3 }) {
+async function convertGenerator({ absolutePathToGeneratorsConfiguration, generator, maybeGroupLevelMetadata, maybeTopLevelMetadata, maybeGroupLevelReviewers, maybeTopLevelReviewers, maybeRootAutomation, maybeGroupAutomation, readme, context: context3 }) {
   const { normalizedName, containerImage } = getGeneratorNameAndImage(generator, context3);
   return {
     raw: generator,
+    automation: generators_yml_exports.resolveAutomationConfig({
+      rootAutomation: maybeRootAutomation,
+      groupAutomation: maybeGroupAutomation,
+      generatorAutomation: generator.automation
+    }),
     name: normalizedName,
     containerImage,
     version: generator.version,
@@ -627388,7 +627532,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "4.65.3-6-gfc20f801ab1",
+          version: "4.66.0",
           usingAccessToken: true
         }
       });
@@ -627439,7 +627583,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "4.65.3-6-gfc20f801ab1",
+        version: "4.66.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -843668,7 +843812,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "4.65.3-6-gfc20f801ab1";
+  const version7 = "4.66.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -846076,6 +846220,7 @@ async function visitGeneratorsYamlAst(contents, cliVersion, visitor) {
     ai: noop2,
     autorelease: noop2,
     replay: noop2,
+    automation: noop2,
     groups: async (groups2) => {
       await visitGeneratorGroups({ groups: groups2, visitor, nodePath: ["groups"], cliVersion });
     }
@@ -852784,7 +852929,7 @@ async function retryWithRateLimit({ fn: fn5, retryRateLimited, logger: logger4,
 
 // ../generation/remote-generation/remote-workspace-runner/lib/createAndStartJob.js
 var gzipAsync = (0, import_util19.promisify)(import_zlib5.gzip);
-async function createAndStartJob({ projectConfig, workspace, organization, intermediateRepresentation, generatorInvocation, version: version7, context: context3, shouldLogS3Url, token, whitelabel, irVersionOverride, absolutePathToPreview, fernignorePath, skipFernignore, retryRateLimited }) {
+async function createAndStartJob({ projectConfig, workspace, organization, intermediateRepresentation, generatorInvocation, version: version7, context: context3, shouldLogS3Url, token, whitelabel, irVersionOverride, absolutePathToPreview, fernignorePath, skipFernignore, retryRateLimited, automationMode, autoMerge }) {
   let fernignoreContents;
   if (skipFernignore) {
     fernignoreContents = "";
@@ -852807,7 +852952,9 @@ async function createAndStartJob({ projectConfig, workspace, organization, inter
       token,
       whitelabel,
       absolutePathToPreview,
-      fernignoreContents
+      fernignoreContents,
+      automationMode,
+      autoMerge
     }),
     retryRateLimited,
     logger: context3.logger,
@@ -852839,6 +852986,12 @@ async function createJob({ projectConfig, workspace, organization, generatorInvo
     whitelabel,
     preview: absolutePathToPreview != null,
     fernignoreContents
+    // TODO(FER-9671): Pass automation flags to Fiddle once its API is updated:
+    //   automationMode,
+    //   autoMerge,
+    //   runId: process.env.FERN_RUN_ID
+    // Fiddle will use these for server-side no-diff detection, separate PRs,
+    // automerge, run_id correlation, and breaking change handling.
   });
   if (!createResponse.ok) {
     const rawError = createResponse.error;
@@ -853417,7 +853570,7 @@ var SourceUploader = class {
 };
 
 // ../generation/remote-generation/remote-workspace-runner/lib/runRemoteGenerationForGenerator.js
-async function runRemoteGenerationForGenerator({ projectConfig, organization, workspace, interactiveTaskContext, generatorInvocation, version: version7, audiences, shouldLogS3Url, token, whitelabel, irVersionOverride, absolutePathToPreview, readme, fernignorePath, skipFernignore, dynamicIrOnly, retryRateLimited, requireEnvVars }) {
+async function runRemoteGenerationForGenerator({ projectConfig, organization, workspace, interactiveTaskContext, generatorInvocation, version: version7, audiences, shouldLogS3Url, token, whitelabel, irVersionOverride, absolutePathToPreview, readme, fernignorePath, skipFernignore, dynamicIrOnly, retryRateLimited, requireEnvVars, automationMode, autoMerge }) {
   const fdr = createFdrService({ token: token.value });
   const fdrOrigin = "https://registry-dev2.buildwithfern.com";
   const isAirGapped = await detectAirGappedMode(`${fdrOrigin}/health`, interactiveTaskContext.logger);
@@ -853582,7 +853735,9 @@ async function runRemoteGenerationForGenerator({ projectConfig, organization, wo
     absolutePathToPreview,
     fernignorePath,
     skipFernignore,
-    retryRateLimited
+    retryRateLimited,
+    automationMode,
+    autoMerge
   });
   interactiveTaskContext.logger.debug(`Job ID: ${job.jobId}`);
   const taskId = job.taskIds[0];
@@ -853717,7 +853872,7 @@ async function uploadDynamicIRForSdkGeneration({ fdr, organization, version: ver
 }
 
 // ../generation/remote-generation/remote-workspace-runner/lib/runRemoteGenerationForAPIWorkspace.js
-async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization, workspace, context: context3, generatorGroup, version: version7, shouldLogS3Url, token, whitelabel, absolutePathToPreview, mode, fernignorePath, skipFernignore, dynamicIrOnly, validateWorkspace, retryRateLimited, requireEnvVars }) {
+async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization, workspace, context: context3, generatorGroup, version: version7, shouldLogS3Url, token, whitelabel, absolutePathToPreview, mode, fernignorePath, skipFernignore, dynamicIrOnly, validateWorkspace, retryRateLimited, requireEnvVars, automationMode, autoMerge }) {
   if (generatorGroup.generators.length === 0) {
     context3.logger.warn("No generators specified.");
     return null;
@@ -853777,7 +853932,9 @@ async function runRemoteGenerationForAPIWorkspace({ projectConfig, organization,
       skipFernignore,
       dynamicIrOnly,
       retryRateLimited,
-      requireEnvVars
+      requireEnvVars,
+      automationMode,
+      autoMerge
     });
     if (remoteTaskHandlerResponse != null && remoteTaskHandlerResponse.createdSnippets) {
       snippetsProducedBy.push(generatorInvocation);
@@ -854866,7 +855023,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "4.65.3-6-gfc20f801ab1"
+        cliVersion: "4.66.0"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
         return { success: false };
@@ -906235,7 +906392,8 @@ var LocalTaskHandler = class {
         autoVersioningCommitMessage: autoVersionResult.commitMessage,
         autoVersioningChangelogEntry: autoVersionResult.changelogEntry,
         autoVersioningPrDescription: autoVersionResult.prDescription,
-        autoVersioningVersionBumpReason: autoVersionResult.versionBumpReason
+        autoVersioningVersionBumpReason: autoVersionResult.versionBumpReason,
+        autoVersioningVersionBump: autoVersionResult.versionBump
       };
     }
     return { shouldCommit: true, autoVersioningCommitMessage: void 0 };
@@ -906394,7 +906552,8 @@ var LocalTaskHandler = class {
         commitMessage,
         changelogEntry,
         prDescription,
-        versionBumpReason
+        versionBumpReason,
+        versionBump: finalBump
       };
     } catch (error50) {
       if (error50 instanceof AutoVersioningException) {
@@ -906897,7 +907056,7 @@ function getGeneratorOutputSubfolder(generatorName) {
 }
 
 // ../generation/local-generation/local-workspace-runner/lib/runLocalGenerationForWorkspace.js
-async function runLocalGenerationForWorkspace({ token, projectConfig, workspace, generatorGroup, version: version7, keepDocker, inspect: inspect6, context: context3, absolutePathToPreview, runner, ai: ai7, replay, noReplay, validateWorkspace, requireEnvVars, skipFernignore, publishToRegistry, isPreview: isPreviewOverride }) {
+async function runLocalGenerationForWorkspace({ token, projectConfig, workspace, generatorGroup, version: version7, keepDocker, inspect: inspect6, context: context3, absolutePathToPreview, runner, ai: ai7, replay, noReplay, validateWorkspace, requireEnvVars, skipFernignore, publishToRegistry, isPreview: isPreviewOverride, automationMode, autoMerge }) {
   const userProvidedVersion = version7;
   if (userProvidedVersion != null) {
     if (absolutePathToPreview != null) {
@@ -907062,7 +907221,7 @@ generators:
         absolutePathToLocalSnippetJSON = AbsoluteFilePath2.of((await getWorkspaceTempDir()).path + "/snippet.json");
       }
       const workspaceTempDir = await getWorkspaceTempDir();
-      const { shouldCommit, autoVersioningCommitMessage, autoVersioningChangelogEntry, autoVersioningPrDescription, autoVersioningVersionBumpReason } = await writeFilesToDiskAndRunGenerator({
+      const { shouldCommit, autoVersioningCommitMessage, autoVersioningChangelogEntry, autoVersioningPrDescription, autoVersioningVersionBumpReason, autoVersioningVersionBump } = await writeFilesToDiskAndRunGenerator({
         organization: projectConfig.organization,
         absolutePathToFernConfig: workspace.generatorsConfiguration?.absolutePathToConfiguration ?? projectConfig._absolutePath,
         workspace: fernWorkspace,
@@ -907101,6 +907260,7 @@ generators:
           warn: (msg) => interactiveTaskContext.logger.warn(msg),
           error: (msg) => interactiveTaskContext.logger.error(msg)
         };
+        const hasBreakingChanges = autoVersioningVersionBump === "MAJOR";
         const pipeline5 = new import_generator_cli.PostGenerationPipeline({
           outputDir: absolutePathToLocalOutput,
           replay: { enabled: replay?.enabled === true, skipApplication: noReplay, stageOnly: false },
@@ -907115,7 +907275,12 @@ generators:
             prDescription: autoVersioningPrDescription,
             versionBumpReason: autoVersioningVersionBumpReason,
             previewMode: selfhostedGithubConfig.previewMode,
-            generatorName: generatorInvocation.name
+            generatorName: generatorInvocation.name,
+            automationMode,
+            autoMerge,
+            hasBreakingChanges,
+            breakingChangesSummary: hasBreakingChanges ? autoVersioningPrDescription : void 0,
+            runId: process.env.FERN_RUN_ID
           },
           cliVersion: workspace.cliVersion ?? "unknown",
           generatorVersions: {
@@ -907132,6 +907297,12 @@ generators:
             error: (msg) => interactiveTaskContext.logger.error(source_default.red(msg))
           });
         }
+        if (pipelineResult.steps.github?.skippedNoDiff) {
+          interactiveTaskContext.logger.info(source_default.green("No changes detected \u2014 skipping PR creation"));
+        }
+        if (pipelineResult.steps.github?.autoMergeEnabled) {
+          interactiveTaskContext.logger.info(source_default.green("Automerge enabled on PR"));
+        }
         if (!pipelineResult.success) {
           interactiveTaskContext.failAndThrow(`Post-generation pipeline failed: ${pipelineResult.errors?.join(", ")}`);
         }
@@ -907447,7 +907618,13 @@ var LegacyGeneratorInvocationAdapter = class {
       irVersionOverride: void 0,
       keywords: void 0,
       publishMetadata: void 0,
-      settings: void 0
+      settings: void 0,
+      automation: {
+        generate: true,
+        upgrade: true,
+        preview: true,
+        verify: true
+      }
     };
   }
   buildRaw(target) {
@@ -928442,7 +928619,7 @@ var CliContext = class {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "4.65.3-6-gfc20f801ab1";
+    return "4.66.0";
   }
   getCliName() {
     if (false) {
@@ -937561,6 +937738,47 @@ async function formatWorkspaces({
   );
 }
 
+// src/commands/generate/filterGenerators.ts
+function parseGeneratorArg(generatorArg) {
+  if (generatorArg == null) {
+    return { generatorName: void 0, generatorIndex: void 0 };
+  }
+  const parsed = generatorArg.length > 0 ? Number(generatorArg) : Number.NaN;
+  if (!Number.isNaN(parsed) && Number.isInteger(parsed) && parsed >= 0) {
+    return { generatorName: void 0, generatorIndex: parsed };
+  }
+  return { generatorName: generatorArg, generatorIndex: void 0 };
+}
+function filterGenerators({
+  generators,
+  generatorIndex,
+  generatorName,
+  groupName
+}) {
+  if (generatorIndex != null) {
+    const generator = generators[generatorIndex];
+    if (generator == null) {
+      return {
+        ok: false,
+        error: `Generator index ${generatorIndex} is out of bounds in group '${groupName}' (${generators.length} generators available)`
+      };
+    }
+    return { ok: true, generators: [generator] };
+  }
+  if (generatorName != null) {
+    const filtered = generators.filter((gen) => gen.name === generatorName);
+    if (filtered.length === 0) {
+      const available = generators.map((gen) => gen.name);
+      return {
+        ok: false,
+        error: `Generator '${generatorName}' not found in group '${groupName}'. Available generators: ${available.join(", ")}`
+      };
+    }
+    return { ok: true, generators: filtered };
+  }
+  return { ok: true, generators };
+}
+
 // src/commands/generate/generateAPIWorkspaces.ts
 init_lib6();
 
@@ -937660,6 +937878,7 @@ async function generateWorkspace({
   context: context3,
   groupName,
   generatorName,
+  generatorIndex,
   version: version7,
   shouldLogS3Url,
   token,
@@ -937675,7 +937894,9 @@ async function generateWorkspace({
   dynamicIrOnly,
   noReplay,
   retryRateLimited,
-  requireEnvVars
+  requireEnvVars,
+  automationMode,
+  autoMerge
 }) {
   if (workspace.generatorsConfiguration == null) {
     context3.logger.warn("This workspaces has no generators.yml");
@@ -937720,16 +937941,16 @@ async function generateWorkspace({
       if (group == null) {
         return context3.failAndThrow(`Group '${resolvedGroupName}' does not exist.`);
       }
-      if (generatorName != null) {
-        const filteredGenerators = group.generators.filter((gen) => gen.name === generatorName);
-        if (filteredGenerators.length === 0) {
-          const availableGenerators = group.generators.map((gen) => gen.name);
-          return context3.failAndThrow(
-            `Generator '${generatorName}' not found in group '${resolvedGroupName}'. Available generators: ${availableGenerators.join(", ")}`
-          );
-        }
-        group = { ...group, generators: filteredGenerators };
+      const filterResult = filterGenerators({
+        generators: group.generators,
+        generatorIndex,
+        generatorName,
+        groupName: resolvedGroupName
+      });
+      if (!filterResult.ok) {
+        return context3.failAndThrow(filterResult.error);
       }
+      group = { ...group, generators: filterResult.generators };
       if (lfsOverride != null) {
         group = applyLfsOverride(group, lfsOverride, context3);
       }
@@ -937753,7 +937974,9 @@ async function generateWorkspace({
           noReplay,
           validateWorkspace: true,
           requireEnvVars,
-          skipFernignore
+          skipFernignore,
+          automationMode,
+          autoMerge
         });
       } else if (token != null) {
         const customImageGenerators = group.generators.filter((g19) => g19.containerImage != null);
@@ -937780,7 +938003,9 @@ async function generateWorkspace({
           dynamicIrOnly,
           validateWorkspace: true,
           retryRateLimited,
-          requireEnvVars
+          requireEnvVars,
+          automationMode,
+          autoMerge
         });
       }
     })
@@ -937882,6 +938107,7 @@ async function generateAPIWorkspaces({
   version: version7,
   groupName,
   generatorName,
+  generatorIndex,
   shouldLogS3Url,
   keepDocker,
   useLocalDocker,
@@ -937897,7 +938123,9 @@ async function generateAPIWorkspaces({
   outputDir,
   noReplay,
   retryRateLimited,
-  requireEnvVars
+  requireEnvVars,
+  automationMode,
+  autoMerge
 }) {
   let token = void 0;
   if (!useLocalDocker) {
@@ -937917,14 +938145,27 @@ async function generateAPIWorkspaces({
   }
   for (const workspace of project.apiWorkspaces) {
     const resolvedGroupNames = resolveGroupNamesForWorkspace(groupName, workspace.generatorsConfiguration);
-    for (const generator of workspace.generatorsConfiguration?.groups.filter((group) => resolvedGroupNames == null || resolvedGroupNames.includes(group.groupName)).flatMap((group) => group.generators).filter((generator2) => generatorName == null || generator2.name === generatorName) ?? []) {
-      const { shouldProceed } = await checkOutputDirectory(
-        generator.absolutePathToLocalOutput,
-        cliContext,
-        force
-      );
-      if (!shouldProceed) {
-        cliContext.failAndThrow("Generation cancelled");
+    for (const group of workspace.generatorsConfiguration?.groups.filter(
+      (group2) => resolvedGroupNames == null || resolvedGroupNames.includes(group2.groupName)
+    ) ?? []) {
+      const filterResult = filterGenerators({
+        generators: group.generators,
+        generatorIndex,
+        generatorName,
+        groupName: group.groupName
+      });
+      if (!filterResult.ok) {
+        continue;
+      }
+      for (const generator of filterResult.generators) {
+        const { shouldProceed } = await checkOutputDirectory(
+          generator.absolutePathToLocalOutput,
+          cliContext,
+          force
+        );
+        if (!shouldProceed) {
+          cliContext.failAndThrow("Generation cancelled");
+        }
       }
     }
   }
@@ -937966,6 +938207,7 @@ async function generateAPIWorkspaces({
           version: version7,
           groupName,
           generatorName,
+          generatorIndex,
           shouldLogS3Url,
           token,
           useLocalDocker,
@@ -937980,7 +938222,9 @@ async function generateAPIWorkspaces({
           dynamicIrOnly,
           noReplay,
           retryRateLimited,
-          requireEnvVars
+          requireEnvVars,
+          automationMode,
+          autoMerge
         });
       });
     })
@@ -946557,6 +946801,7 @@ async function tryRunCli(cliContext) {
   addReplayCommand(cli, cliContext);
   addBetaCommand(cli, cliContext);
   addSdkCommand2(cli, cliContext);
+  addAutomationsCommand(cli, cliContext);
   addGetOrganizationCommand(cli, cliContext);
   addGeneratorCommands(cli, cliContext);
   addProtocGenFernCommand(cli, cliContext);
@@ -947029,6 +947274,7 @@ function addGenerateCommand2(cli, cliContext) {
         return cliContext.failWithoutThrowing("The --output flag is not supported for docs generation.");
       }
       const correctedGeneratorFilter = argv.generator != null ? warnAndCorrectIncorrectDockerOrg(argv.generator, cliContext) : void 0;
+      const { generatorName, generatorIndex } = parseGeneratorArg(correctedGeneratorFilter);
       if (argv.api != null) {
         return await generateAPIWorkspaces({
           project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
@@ -947038,7 +947284,8 @@ function addGenerateCommand2(cli, cliContext) {
           cliContext,
           version: argv.version,
           groupName: argv.group,
-          generatorName: correctedGeneratorFilter,
+          generatorName,
+          generatorIndex,
           shouldLogS3Url: argv.printZipUrl,
           keepDocker: argv.keepDocker,
           useLocalDocker: argv.local || argv.runner != null,
@@ -947096,7 +947343,8 @@ function addGenerateCommand2(cli, cliContext) {
         cliContext,
         version: argv.version,
         groupName: argv.group,
-        generatorName: correctedGeneratorFilter,
+        generatorName,
+        generatorIndex,
         shouldLogS3Url: argv.printZipUrl,
         keepDocker: argv.keepDocker,
         useLocalDocker: argv.local,
@@ -948202,6 +948450,133 @@ function addSdkCommand2(cli, cliContext) {
     return yargs.demandCommand();
   });
 }
+function addAutomationsCommand(cli, cliContext) {
+  cli.command("automations", false, (yargs) => {
+    addAutomationsListCommand(yargs, cliContext);
+    addAutomationsGenerateCommand(yargs, cliContext);
+    return yargs.demandCommand();
+  });
+}
+function addAutomationsListCommand(cli, cliContext) {
+  cli.command("list", false, (yargs) => {
+    addAutomationsListGenerateCommand(yargs, cliContext);
+    return yargs.demandCommand();
+  });
+}
+function addAutomationsListGenerateCommand(cli, cliContext) {
+  cli.command(
+    "generate",
+    false,
+    // hidden
+    (yargs) => yargs.option("group", {
+      type: "string",
+      description: "Filter to a specific generator group (e.g. 'sdk'). Omit to list all groups."
+    }).option("api", {
+      type: "string",
+      description: "Filter to a specific API in a multi-API repo (e.g. 'foo' for fern/apis/foo/). Omit to list all APIs."
+    }).option("version", {
+      type: "string",
+      description: "Version string to include in generated commands (e.g. 'AUTO' for AI-based versioning)"
+    }).option("auto-merge", {
+      boolean: true,
+      default: false,
+      description: "Include --auto-merge flag in generated commands"
+    }),
+    async (argv) => {
+      const project = await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
+        commandLineApiWorkspace: argv.api,
+        defaultToAllApiWorkspaces: true
+      });
+      const commands = [];
+      for (const workspace of project.apiWorkspaces) {
+        const groups2 = workspace.generatorsConfiguration?.groups ?? [];
+        for (const group of groups2) {
+          if (argv.group != null && group.groupName !== argv.group) {
+            continue;
+          }
+          for (let i11 = 0; i11 < group.generators.length; i11++) {
+            const generator = group.generators[i11];
+            if (generator == null || !generator.automation.generate) {
+              continue;
+            }
+            const parts = ["fern", "automations", "generate"];
+            if (workspace.workspaceName != null) {
+              parts.push("--api", workspace.workspaceName);
+            }
+            parts.push("--group", group.groupName);
+            parts.push("--generator", String(i11));
+            if (argv.version != null) {
+              parts.push("--version", argv.version);
+            }
+            if (argv["auto-merge"]) {
+              parts.push("--auto-merge");
+            }
+            commands.push(parts.join(" "));
+          }
+        }
+      }
+      process.stdout.write(JSON.stringify(commands));
+    }
+  );
+}
+function addAutomationsGenerateCommand(cli, cliContext) {
+  cli.command(
+    "generate",
+    false,
+    // hidden
+    (yargs) => yargs.option("api", {
+      type: "string",
+      description: "Target a specific API in a multi-API repo (e.g. 'foo' for fern/apis/foo/). Required when the project has multiple APIs."
+    }).option("group", {
+      type: "string",
+      description: "The generator group to run (e.g. 'sdk'). Falls back to default-group in generators.yml if omitted."
+    }).option("generator", {
+      type: "string",
+      description: "Target a specific generator by 0-based index (e.g. '0', '1') or by name. Index is preferred for deterministic targeting when duplicate names exist."
+    }).option("version", {
+      type: "string",
+      description: "Version for generated packages. Use 'AUTO' for AI-based semantic versioning that analyzes the diff and determines MAJOR/MINOR/PATCH automatically."
+    }).option("auto-merge", {
+      boolean: true,
+      default: false,
+      description: "Enable GitHub automerge on generated PRs. Automerge is skipped when breaking changes (MAJOR bump) are detected, regardless of this flag."
+    }),
+    async (argv) => {
+      const { generatorName: genName, generatorIndex: genIndex } = parseGeneratorArg(argv.generator);
+      await cliContext.runTask(async () => {
+        await generateAPIWorkspaces({
+          project: await loadProjectAndRegisterWorkspacesWithContext(cliContext, {
+            commandLineApiWorkspace: argv.api,
+            defaultToAllApiWorkspaces: false
+          }),
+          cliContext,
+          version: argv.version,
+          groupName: argv.group,
+          generatorName: genName,
+          generatorIndex: genIndex,
+          shouldLogS3Url: false,
+          keepDocker: false,
+          useLocalDocker: false,
+          preview: false,
+          mode: void 0,
+          force: true,
+          runner: void 0,
+          inspect: false,
+          lfsOverride: void 0,
+          fernignorePath: void 0,
+          skipFernignore: false,
+          dynamicIrOnly: false,
+          outputDir: void 0,
+          noReplay: false,
+          retryRateLimited: false,
+          requireEnvVars: false,
+          automationMode: true,
+          autoMerge: argv["auto-merge"]
+        });
+      });
+    }
+  );
+}
 function addSdkPreviewCommand(cli, cliContext) {
   cli.command(
     "preview",

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.65.3-6-gfc20f801ab1",
+  "version": "4.66.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",