nx 23.2.0-beta.1 → 23.2.0-beta.10

package/dist/src/command-line/migrate/migrate.d.ts

@@ -5,10 +5,12 @@ import { PackageManagerCommands } from '../../utils/package-manager';
 import { type MigrateFetchStats, type MigrateMultiMajorChoice } from './migrate-analytics';
 import { type MultiMajorMode } from './multi-major';
 import type { AgenticArg } from './agentic/select';
+import { MigrateArgs } from './command-object';
 import type { ResolvedAgentic } from './agentic/types';
-import { isHybridMigration, isPromptOnlyMigration } from './migration-shape';
+import { isHybridMigration, isPromptOnlyMigration, type PlannedMigration } from './migration-shape';
 import { filterDowngradedUpdates } from './update-filters';
 import { normalizeVersion } from './version-utils';
+import { type StepAction } from './step-actions';
 export * from './execute-migration';
 export { normalizeVersion };
 export interface ResolvedMigrationConfiguration extends MigrationsJson {
@@ -63,6 +65,8 @@ export declare class Migrator {
     private readonly packageUpdates;
     private readonly collectedVersions;
     private readonly promptAnswers;
+    private readonly pendingPackageJsonUpdates;
+    private readonly appliedPackageJsonUpdates;
     private readonly nxInstallation;
     private minVersionWithSkippedUpdates;
     constructor(opts: MigratorOptions);
@@ -85,6 +89,8 @@ export declare class Migrator {
     }>;
     private createMigrateJson;
     private buildPackageJsonUpdates;
+    private applyPackageJsonUpdate;
+    private applyPendingPackageJsonUpdates;
     private resolveVersionForCascade;
     private populatePackageJsonUpdatesAndGetPackagesToCheck;
     private getPackageJsonUpdatesFromMigrationConfig;
@@ -166,88 +172,43 @@ type RunMigrations = {
     validate?: boolean;
     interactive?: boolean;
 };
-export declare function parseMigrationsOptions(options: {
-    [k: string]: any;
-}, fetch?: MigratorOptions['fetch']): Promise<GenerateMigrations | RunMigrations>;
+type RunSingleMigration = {
+    type: 'runSingleMigration';
+    runMigration: string;
+    runId?: string;
+    agentic: AgenticArg;
+    validate?: boolean;
+    interactive?: boolean;
+};
+type OrchestratorReconcile = {
+    type: 'orchestratorReconcile';
+    runId: string;
+    stepAction?: StepAction;
+};
+export declare function parseMigrationsOptions(options: MigrateArgs, fetch?: MigratorOptions['fetch']): Promise<GenerateMigrations | RunMigrations | RunSingleMigration | OrchestratorReconcile>;
 export declare function createFetcher(pmc: PackageManagerCommands): ((pkg: string, version: string) => Promise<ResolvedMigrationConfiguration>) & {
     stats?: MigrateFetchStats;
 };
 export { filterDowngradedUpdates };
 export declare function generateMigrationsJsonAndUpdatePackageJson(root: string, opts: GenerateMigrations, fetch?: MigratorOptions['fetch']): Promise<void>;
-type ExecutableMigration = {
-    package: string;
-    name: string;
-    description?: string;
-    version: string;
-    implementation?: string;
-    factory?: string;
-    prompt?: string;
-    documentation?: string;
-};
 export { isPromptOnlyMigration, isHybridMigration };
-export declare function resolveAgenticRunId(migrations: ExecutableMigration[]): string;
-export declare function formatSkippedPromptsNextStep(skipped: ExecutableMigration[]): string;
-/**
- * Resolves the effective `--create-commits` state once the agentic flow has
- * been resolved. The agent's outer prompt only embeds the impl-phase file list
- * when per-migration commits isolate each migration's diff, so the diff-context
- * flag returned here gates that section.
- */
-export declare function resolveCreateCommits(args: {
-    createCommits: boolean | undefined;
-    agenticKind: ResolvedAgentic['kind'];
-    isGitRepo: boolean;
-    /**
-     * Whether `--commit-prefix` was given a non-default value. When commits
-     * end up disabled, the prefix has no effect — the warning copy below
-     * surfaces that so the user isn't silently misled.
-     */
-    commitPrefixIsCustom?: boolean;
-}): {
-    effective: boolean;
-    agenticHasDiffContext: boolean;
-    warning?: string;
-    error?: string;
-};
-/**
- * Confirms before creating per-migration commits while the user sits on the
- * repository's default branch, so migrations don't silently commit there (most
- * relevant since `--agentic` enables commits by default). Only the default
- * branch triggers a prompt; a detached HEAD, a different branch, or an
- * unresolved default branch all proceed untouched. Callers gate this on
- * commits being effective and prompting being possible, so non-interactive
- * runs (CI, `--no-interactive`) never reach here.
- */
-export declare function confirmCommitsOnDefaultBranch(args: {
-    currentBranch: string | null;
-    defaultBranch: string | null;
-}): Promise<boolean>;
-/**
- * Resolves whether the framework-owned generic-validation agent step should run
- * after generator-only migrations.
- *
- * Default-on when the agentic flow resolved to `enabled`; silently ignored
- * otherwise (no warning emitted) — `--validate` requires an active agent
- * session by definition. An explicit `--no-validate` (`validate === false`)
- * opts out even when agentic is enabled.
- */
-export declare function resolveShouldRunValidation(args: {
-    validate: boolean | undefined;
-    agenticKind: ResolvedAgentic['kind'];
-}): boolean;
-export declare function executeMigrations(root: string, migrations: ExecutableMigration[], isVerbose: boolean, shouldCreateCommits: boolean, commitPrefix: string, shouldSkipInstall?: boolean, agentic?: ResolvedAgentic, agenticHasDiffContext?: boolean, shouldRunValidation?: boolean): Promise<{
-    migrationsWithNoChanges: ExecutableMigration[];
+export declare function formatSkippedPromptsNextStep(skipped: PlannedMigration[]): string;
+export declare function executeMigrations(root: string, migrations: PlannedMigration[], isVerbose: boolean, shouldCreateCommits: boolean, commitPrefix: string, shouldSkipInstall?: boolean, agentic?: ResolvedAgentic, agenticHasDiffContext?: boolean, shouldRunValidation?: boolean): Promise<{
+    migrationsWithNoChanges: PlannedMigration[];
     skippedPromptsCount: number;
     notRunMigrationsCount: number;
     nextSteps: string[];
-    skippedPrompts: ExecutableMigration[];
+    skippedPrompts: PlannedMigration[];
     migrationEmittedNextSteps: string[];
     committedShasCount: number;
+    waivedAgenticStepsCount: number;
     retainedAtSuccess: string[];
 }>;
+export declare function isRunPhaseInvocation(args: Pick<MigrateArgs, 'runMigration' | 'runId' | 'stepAction'>): boolean;
 export declare function migrate(root: string, args: {
     [k: string]: any;
 }, rawArgs: string[]): Promise<number>;
+export declare function readLocalNxVersion(root: string): string | undefined;
 export declare function runMigration(): Promise<number>;
 /**
  * Resolves a migration's collection once and derives everything the run loop
@@ -278,5 +239,4 @@ export declare function resolveMigrationForRun(root: string, migration: {
     };
     documentationPath?: string;
 };
-export declare function resolveDocumentationFileToWorkspacePath(root: string, migrationsDir: string, documentation: string): string | undefined;
 export declare function nxCliPath(nxWorkspaceRoot?: string): Promise<string>;