Reverse approach: keep vnext as main command, move old to legacy with aliases

Co-authored-by: tylerbutler <[email protected]>

Author: Copilot

build-tools/packages/build-cli/docs/generate.md

@@ -6,7 +6,6 @@ Generate commands are used to create/update code, docs, readmes, etc.
 * [`flub generate assertTags`](#flub-generate-asserttags)
 * [`flub generate buildVersion`](#flub-generate-buildversion)
 * [`flub generate bundleStats`](#flub-generate-bundlestats)
-* [`flub generate changelog`](#flub-generate-changelog)
 * [`flub generate changeset`](#flub-generate-changeset)
 * [`flub generate compatLayerGeneration`](#flub-generate-compatlayergeneration)
 * [`flub generate entrypoints`](#flub-generate-entrypoints)
@@ -138,38 +137,6 @@ DESCRIPTION
 
 _See code: [src/commands/generate/bundleStats.ts](https://github.com/microsoft/FluidFramework/blob/main/build-tools/packages/build-cli/src/commands/generate/bundleStats.ts)_
 
-## `flub generate changelog`
-
-Generate a changelog for packages based on changesets. Note that this process deletes the changeset files!
-
-```
-USAGE
-  $ flub generate changelog -g <value> [-v | --quiet] [--version <value>]
-
-FLAGS
-  -g, --releaseGroup=<value>  (required) The name of a release group.
-      --version=<value>       The version for which to generate the changelog. If this is not provided, the version of
-                              the package according to package.json will be used.
-
-LOGGING FLAGS
-  -v, --verbose  Enable verbose logging.
-      --quiet    Disable all logging.
-
-DESCRIPTION
-  Generate a changelog for packages based on changesets. Note that this process deletes the changeset files!
-
-ALIASES
-  $ flub vnext generate changelog
-  $ flub vnext generate changelogs
-
-EXAMPLES
-  Generate changelogs for the client release group.
-
-    $ flub generate changelog --releaseGroup client
-```
-
-_See code: [src/commands/generate/changelog.ts](https://github.com/microsoft/FluidFramework/blob/main/build-tools/packages/build-cli/src/commands/generate/changelog.ts)_
-
 ## `flub generate changeset`
 
 Generates a new changeset file. You will be prompted to select the packages affected by this change. You can also create an empty changeset to include with this change that can be updated later.

build-tools/packages/build-cli/docs/legacy.md

@@ -7,7 +7,7 @@ Legacy commands that have been replaced by newer implementations.
 
 ## `flub legacy generate changelog`
 
-[DEPRECATED] Generate a changelog for packages based on changesets. Use 'flub generate changelog' instead.
+[DEPRECATED] Generate a changelog for packages based on changesets. Use 'flub vnext generate changelog' instead.
 
 ```
 USAGE
@@ -26,7 +26,7 @@ LOGGING FLAGS
       --quiet    Disable all logging.
 
 DESCRIPTION
-  [DEPRECATED] Generate a changelog for packages based on changesets. Use 'flub generate changelog' instead.
+  [DEPRECATED] Generate a changelog for packages based on changesets. Use 'flub vnext generate changelog' instead.
 
 EXAMPLES
   Generate changelogs for the client release group.

build-tools/packages/build-cli/docs/vnext.md

@@ -4,6 +4,7 @@
 Vnext commands are new implementations of standard flub commands using new infrastructure.
 
 * [`flub vnext check latestVersions`](#flub-vnext-check-latestversions)
+* [`flub vnext generate changelog`](#flub-vnext-generate-changelog)
 
 ## `flub vnext check latestVersions`
 
@@ -31,3 +32,36 @@ DESCRIPTION
 ```
 
 _See code: [src/commands/vnext/check/latestVersions.ts](https://github.com/microsoft/FluidFramework/blob/main/build-tools/packages/build-cli/src/commands/vnext/check/latestVersions.ts)_
+
+## `flub vnext generate changelog`
+
+Generate a changelog for packages based on changesets. Note that this process deletes the changeset files!
+
+```
+USAGE
+  $ flub vnext generate changelog -g <value> [-v | --quiet] [--version <value>]
+
+FLAGS
+  -g, --releaseGroup=<value>  (required) The name of a release group.
+      --version=<value>       The version for which to generate the changelog. If this is not provided, the version of
+                              the package according to package.json will be used.
+
+LOGGING FLAGS
+  -v, --verbose  Enable verbose logging.
+      --quiet    Disable all logging.
+
+DESCRIPTION
+  Generate a changelog for packages based on changesets. Note that this process deletes the changeset files!
+
+ALIASES
+  $ flub vnext generate changelogs
+  $ flub generate changelog
+  $ flub generate changelogs
+
+EXAMPLES
+  Generate changelogs for the client release group.
+
+    $ flub vnext generate changelog --releaseGroup client
+```
+
+_See code: [src/commands/vnext/generate/changelog.ts](https://github.com/microsoft/FluidFramework/blob/main/build-tools/packages/build-cli/src/commands/vnext/generate/changelog.ts)_

build-tools/packages/build-cli/src/commands/legacy/generate/changelog.ts

@@ -16,7 +16,7 @@ import { inc } from "semver";
 import { CleanOptions } from "simple-git";
 
 import { checkFlags, releaseGroupFlag, semverFlag } from "../../../flags.js";
-// eslint-disable-next-line import/no-internal-modules
+// eslint-disable-next-line import-x/no-internal-modules
 import { canonicalizeChangesets } from "../../../library/changesets.js";
 import { BaseCommand } from "../../../library/index.js";
 import { isReleaseGroup } from "../../../releaseGroups.js";
@@ -38,17 +38,16 @@ async function replaceInFile(
  * https://github.com/changesets/changesets/issues/595. What we would like to do is generate the changelogs without
  * doing version bumping, but that feature does not exist in the changeset tools.
  *
- * @deprecated This command is deprecated. Use 'flub generate changelog' instead.
+ * @deprecated This command is deprecated. Use 'flub vnext generate changelog' instead.
  */
 export default class GenerateChangeLogCommand extends BaseCommand<
 	typeof GenerateChangeLogCommand
 > {
 	static readonly description =
-		"[DEPRECATED] Generate a changelog for packages based on changesets. Use 'flub generate changelog' instead.";
+		"[DEPRECATED] Generate a changelog for packages based on changesets. Use 'flub vnext generate changelog' instead.";
 
-	static readonly deprecateAliases = true;
 	static readonly deprecated = {
-		message: "This command is deprecated. Use 'flub generate changelog' instead.",
+		message: "This command is deprecated. Use 'flub vnext generate changelog' instead.",
 	};
 
 	static readonly flags = {

build-tools/packages/build-cli/src/commands/generate/changelog.ts renamed to build-tools/packages/build-cli/src/commands/vnext/generate/changelog.ts

@@ -8,12 +8,12 @@ import { command as execCommand } from "execa";
 import { parse } from "semver";
 
 import { setVersion } from "@fluid-tools/build-infrastructure";
-import { releaseGroupNameFlag, semverFlag } from "../../flags.js";
+import { releaseGroupNameFlag, semverFlag } from "../../../flags.js";
 // eslint-disable-next-line import/no-internal-modules
-import { updateChangelogs } from "../../library/changelogs.js";
-// eslint-disable-next-line import-x/no-internal-modules
-import { canonicalizeChangesets } from "../../library/changesets.js";
-import { BaseCommandWithBuildProject } from "../../library/index.js";
+import { updateChangelogs } from "../../../library/changelogs.js";
+// eslint-disable-next-line import/no-internal-modules
+import { canonicalizeChangesets } from "../../../library/changesets.js";
+import { BaseCommandWithBuildProject } from "../../../library/index.js";
 
 /**
  * Generate a changelog for packages based on changesets. Note that this process deletes the changeset files!
@@ -28,8 +28,7 @@ export default class GenerateChangeLogCommand extends BaseCommandWithBuildProjec
 	static readonly description =
 		"Generate a changelog for packages based on changesets. Note that this process deletes the changeset files!";
 
-	static readonly aliases = ["vnext:generate:changelog", "vnext:generate:changelogs"];
-	static readonly deprecateAliases = true;
+	static readonly aliases = ["vnext:generate:changelogs", "generate:changelog", "generate:changelogs"];
 
 	static readonly flags = {
 		releaseGroup: releaseGroupNameFlag({ required: true }),