nx 23.0.0-beta.21 → 23.0.0-beta.22

package/dist/src/command-line/release/version/derive-specifier-from-conventional-commits.js

@@ -15,11 +15,12 @@ isPrerelease, latestMatchingGitTag, releaseGraph, fallbackCurrentVersionResolver
         ? [projectGraphNode.name]
         : releaseGroup.projects;
     // latestMatchingGitTag will be undefined if the current version was resolved from the disk fallback.
-    // In this case, we want to use the first commit as the ref to be consistent with the changelog command.
+    // In this case, use the first commit that touched this project rather than the repo's first commit,
+    // to avoid scanning the entire git history for projects that were added after the repo was created.
     const previousVersionRef = latestMatchingGitTag
         ? latestMatchingGitTag.tag
         : fallbackCurrentVersionResolver === 'disk'
-            ? await (0, git_1.getFirstGitCommit)()
+            ? await (0, git_1.getFirstProjectCommit)(projectGraphNode.data.root)
             : undefined;
     if (!previousVersionRef) {
         // This should never happen since the checks above should catch if the current version couldn't be resolved

package/dist/src/command-line/release/version.d.ts

@@ -1,5 +1,7 @@
 import { NxReleaseConfiguration } from '../../config/nx-json';
+import type { ProjectGraph } from '../../config/project-graph';
 import { VersionOptions } from './command-object';
+import { type NxReleaseConfig } from './config/config';
 import { ReleaseGraph } from './utils/release-graph';
 import { VersionData } from './utils/shared';
 export interface NxReleaseVersionResult {
@@ -23,3 +25,4 @@ export interface NxReleaseVersionResult {
 }
 export declare const releaseVersionCLIHandler: (args: VersionOptions) => Promise<number>;
 export declare function createAPI(overrideReleaseConfig: NxReleaseConfiguration, ignoreNxJsonConfig: boolean): (args: VersionOptions) => Promise<NxReleaseVersionResult>;
+export declare function hasDockerReleaseConfiguration(nxReleaseConfig: NxReleaseConfig, releaseGraph: ReleaseGraph, projectGraph: ProjectGraph): boolean;

package/dist/src/command-line/release/version.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.releaseVersionCLIHandler = void 0;
 exports.createAPI = createAPI;
+exports.hasDockerReleaseConfiguration = hasDockerReleaseConfiguration;
 const tslib_1 = require("tslib");
 const pc = tslib_1.__importStar(require("picocolors"));
 const node_child_process_1 = require("node:child_process");
@@ -212,17 +213,17 @@ function createAPI(overrideReleaseConfig, ignoreNxJsonConfig) {
                 }, releaseGroup, true);
             }
         }
+        const shouldProcessDockerProjects = hasDockerReleaseConfiguration(nxReleaseConfig, releaseGraph, projectGraph);
         // TODO(colum): Remove when Docker support is no longer experimental
-        if (nxReleaseConfig.docker ||
-            releaseGraph.releaseGroups.some((rg) => rg.docker)) {
+        if (shouldProcessDockerProjects) {
             output_1.output.warn({
                 title: 'Warning',
                 bodyLines: [
                     `Docker support is experimental. Breaking changes may occur and not adhere to semver versioning.`,
                 ],
             });
+            await processor.processDockerProjects(args.dockerVersionScheme, args.dockerVersion);
         }
-        await processor.processDockerProjects(args.dockerVersionScheme, args.dockerVersion);
         const versionData = processor.getVersionData();
         // Resolve any git tags as early as possible so that we can hard error in case of any duplicates before reaching the actual git command
         const gitTagValues = (args.gitTag ?? nxReleaseConfig.version.git.tag)
@@ -298,6 +299,15 @@ function createAPI(overrideReleaseConfig, ignoreNxJsonConfig) {
         };
     };
 }
+function hasDockerReleaseConfiguration(nxReleaseConfig, releaseGraph, projectGraph) {
+    if (nxReleaseConfig.docker) {
+        return true;
+    }
+    if (releaseGraph.releaseGroups.some((rg) => rg.docker)) {
+        return true;
+    }
+    return Array.from(releaseGraph.allProjectsToProcess).some((projectName) => projectGraph.nodes[projectName]?.data.release?.docker !== undefined);
+}
 function printAndFlushChanges(tree, isDryRun) {
     const changes = tree.listChanges();
     console.log('');

package/dist/src/config/misc-interfaces.d.ts

@@ -84,6 +84,13 @@ export interface MigrationsJsonEntry {
     factory?: string;
     prompt?: string;
     requires?: Record<string, string>;
+    /**
+     * Path to a markdown doc describing the migration, relative to the
+     * `migrations.json` and resolved like `implementation`/`factory`. Always
+     * supplementary; never stands in for them. Under `--run-migrations
+     * --agentic` the resolved path is passed to the agent as extra context.
+     */
+    documentation?: string;
 }
 export type MigrationDetailsWithId = GeneratedMigrationDetails & {
     id: string;
@@ -95,6 +102,7 @@ export interface GeneratedMigrationDetails {
     description: string;
     implementation?: string;
     prompt?: string;
+    documentation?: string;
 }
 export interface MigrationsJson {
     name?: string;

package/dist/src/config/nx-json.d.ts

@@ -1,6 +1,8 @@
 import type ChangelogRenderer from '../../release/changelog-renderer';
 import type { ChangelogRenderOptions } from '../../release/changelog-renderer';
 import type { validReleaseVersionPrefixes } from '../command-line/release/utils/release-graph';
+import type { AgentId } from '../command-line/migrate/agentic/cli-args';
+import type { MigrateMode, MultiMajorMode } from '../command-line/migrate/command-object';
 import type { PackageManager } from '../utils/package-manager';
 import type { InputDefinition, TargetConfiguration, TargetDependencyConfig } from './workspace-json-project-json';
 export type ImplicitDependencyEntry<T = '*' | string[]> = {
@@ -651,6 +653,49 @@ export interface NxSyncConfiguration {
      */
     disabledTaskSyncGenerators?: string[];
 }
+export interface NxMigrateConfiguration {
+    /**
+     * Whether to automatically create a git commit after each migration runs.
+     * Equivalent to the `--create-commits` flag. Defaults to `false`.
+     */
+    createCommits?: boolean;
+    /**
+     * Commit message prefix applied to each migration commit when commits are
+     * enabled (via `createCommits` or `--create-commits`). Equivalent to the
+     * `--commit-prefix` flag. Defaults to `"chore: [nx migration] "`.
+     */
+    commitPrefix?: string;
+    /**
+     * Restricts which packages to migrate when migrating Nx itself. Equivalent to
+     * the `--mode` flag.
+     * - `first-party`: only Nx and its plugins.
+     * - `third-party`: only the third-party dependencies referenced by Nx.
+     * - `all`: everything (default).
+     */
+    mode?: MigrateMode;
+    /**
+     * How to handle a migration that crosses more than one major version.
+     * Equivalent to the `--multi-major-mode` flag. The `NX_MULTI_MAJOR_MODE`
+     * environment variable takes precedence over this setting.
+     * - `direct`: migrate straight to the requested target.
+     * - `gradual`: migrate to the smallest recommended step.
+     */
+    multiMajorMode?: MultiMajorMode;
+    /**
+     * Default for the agentic flow used by `nx migrate --run-migrations`.
+     * Equivalent to the `--agentic` flag.
+     * - `false`: never use the agentic flow.
+     * - `true`: use the agentic flow and resolve the installed agent.
+     * - an agent id (`"claude-code"`, `"codex"`, `"opencode"`): always use that agent.
+     */
+    agentic?: boolean | AgentId;
+    /**
+     * Whether to run agent-driven validation after generator-only migrations when
+     * the agentic flow is enabled. Equivalent to the `--validate` flag. Defaults
+     * to `true` when the agentic flow is enabled.
+     */
+    validate?: boolean;
+}
 /**
  * Nx.json configuration
  *
@@ -810,6 +855,10 @@ export interface NxJsonConfiguration<T = '*' | string[]> {
      * Configuration for the `nx sync` command.
      */
     sync?: NxSyncConfiguration;
+    /**
+     * Configuration for the `nx migrate` command.
+     */
+    migrate?: NxMigrateConfiguration;
     /**
      * Sets the maximum size of the local cache. Accepts a number followed by a unit (e.g. 100MB). Accepted units are B, KB, MB, and GB.
      */