@ohos-ports/nx 23.2.0-beta.0 → 23.2.1-beta.0

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

@@ -1,24 +0,0 @@
-import { AgentId, ResolvedAgentic } from './types';
-/** Possible values for `--agentic` after yargs normalization. */
-export type AgenticArg = undefined | boolean | AgentId;
-export interface ResolveAgenticInput {
-    agentic: AgenticArg;
-    migrations: ReadonlyArray<{
-        prompt?: string;
-    }>;
-    /** The `--interactive` flag; `false` (`--no-interactive`) disables all prompting. */
-    interactive?: boolean;
-}
-/**
- * Callers resolve this once per run-phase invocation and reuse the result for
- * every migration it covers.
- */
-export declare function resolveAgentic(input: ResolveAgenticInput): Promise<ResolvedAgentic>;
-/**
- * No warning when `--validate` is passed with the agentic flow off: validation
- * requires an active agent session by definition.
- */
-export declare function resolveShouldRunValidation(args: {
-    validate: boolean | undefined;
-    agenticKind: ResolvedAgentic['kind'];
-}): boolean;

package/dist/src/command-line/migrate/agentic/select.js

@@ -1,251 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveAgentic = resolveAgentic;
-exports.resolveShouldRunValidation = resolveShouldRunValidation;
-const fs_1 = require("fs");
-const jsonc_parser_1 = require("jsonc-parser");
-const path_1 = require("path");
-const output_1 = require("../../../utils/output");
-const workspace_root_1 = require("../../../utils/workspace-root");
-const migrate_analytics_1 = require("../migrate-analytics");
-const safe_prompt_1 = require("../safe-prompt");
-const detect_installed_1 = require("./detect-installed");
-const inception_1 = require("./inception");
-const definitions_1 = require("./definitions");
-const INSTALL_SUPPORTED_AGENTS_HINT = [
-    'Install one of the supported agents and re-run the migration:',
-    ...definitions_1.AGENT_DEFINITIONS.map((def) => `  - ${def.displayName}`),
-];
-/**
- * Callers resolve this once per run-phase invocation and reuse the result for
- * every migration it covers.
- */
-async function resolveAgentic(input) {
-    if ((0, inception_1.isInsideAgent)()) {
-        output_1.output.log({
-            title: input.agentic === true || typeof input.agentic === 'string'
-                ? 'Agentic flow skipped: nx detected this run is invoked from inside an AI agent — the outer agent drives the migration. The explicit --agentic flag is ignored in this context.'
-                : 'Agentic flow skipped: nx detected this run is invoked from inside an AI agent.',
-        });
-        return { kind: 'inside-agent' };
-    }
-    const isInteractive = !!process.stdin.isTTY &&
-        !!process.stdout.isTTY &&
-        input.interactive !== false;
-    // Skip detection for the one case where the result is unused: explicit
-    // `--agentic=false`. For every other path (explicit enable, explicit id, or
-    // undefined-with-prompt) we either need the detection result to pick/verify
-    // an agent or to decide whether the up-front prompt is even worth asking.
-    if (input.agentic === false) {
-        return { kind: 'disabled' };
-    }
-    const detected = await (0, detect_installed_1.detectInstalledAgents)(definitions_1.AGENT_DEFINITIONS);
-    const { enabled, explicitId, persist } = await resolveFlag(input, isInteractive, detected);
-    if (!enabled) {
-        if (persist === false) {
-            persistAgenticChoice(false);
-        }
-        return { kind: 'disabled' };
-    }
-    const selected = await selectAgent(detected, explicitId, isInteractive);
-    if (persist === true) {
-        persistAgenticChoice(true);
-    }
-    else if (persist === 'pin') {
-        persistAgenticChoice(selected.id);
-    }
-    return { kind: 'enabled', selectedAgent: selected };
-}
-/**
- * No warning when `--validate` is passed with the agentic flow off: validation
- * requires an active agent session by definition.
- */
-function resolveShouldRunValidation(args) {
-    return args.validate !== false && args.agenticKind === 'enabled';
-}
-async function resolveFlag(input, isInteractive, detected) {
-    if (input.agentic === true) {
-        if (!isInteractive) {
-            warnAgenticInteractiveOnly();
-            return { enabled: false };
-        }
-        return { enabled: true };
-    }
-    if (typeof input.agentic === 'string') {
-        if (!isInteractive) {
-            warnAgenticInteractiveOnly();
-            return { enabled: false };
-        }
-        return { enabled: true, explicitId: input.agentic };
-    }
-    // undefined — fire the up-front prompt only when we have a TTY, something
-    // agentic-eligible is queued, and at least one agent is installed. Without
-    // an installed agent the user can't say "Yes" meaningfully — asking would
-    // walk them into a dead end.
-    if (!isInteractive) {
-        return { enabled: false };
-    }
-    if (!input.migrations.some((m) => !!m.prompt)) {
-        return { enabled: false };
-    }
-    if (detected.length === 0) {
-        return { enabled: false };
-    }
-    return firePromptForAgentic(input.migrations, detected);
-}
-function requireInteractiveOrAbort(isInteractive) {
-    if (isInteractive)
-        return;
-    output_1.output.error({
-        title: 'The agentic flow is interactive-only in this release.',
-        bodyLines: [
-            'Re-run in an interactive terminal, or pass `--agentic=false` to skip the agentic flow.',
-        ],
-    });
-    throw new Error('Agentic flow requires an interactive terminal.');
-}
-function warnAgenticInteractiveOnly() {
-    output_1.output.warn({
-        title: 'Skipping the agentic flow: it is interactive-only in this release and this run is non-interactive.',
-        bodyLines: [
-            'Continuing the migration without the agentic flow. Re-run in an interactive terminal to use it.',
-        ],
-    });
-}
-async function firePromptForAgentic(migrations, detected) {
-    // The apply hint assumes at least one prompt-bearing migration is queued. If
-    // we later extend the prompt to fire for generator-only runs (validation-
-    // only), the hint needs to branch.
-    const promptCount = migrations.filter((m) => !!m.prompt).length;
-    const applyHint = `Apply ${promptCount} prompt migration${promptCount === 1 ? '' : 's'} and validate generator output with an AI agent`;
-    const skipHint = `Skip prompts and run generators without AI validation`;
-    const rememberHint = `Saved to nx.json so Nx won't ask again`;
-    // The pin-vs-flexible distinction only matters when more than one agent is
-    // installed. With a single agent, "always" simply persists `true` and the
-    // pin option is dropped.
-    const multipleAgents = detected.length > 1;
-    const pinChoice = multipleAgents
-        ? [
-            {
-                value: 'yes-pin',
-                label: 'Yes, always with the same agent',
-                hint: rememberHint,
-            },
-        ]
-        : [];
-    const choices = [
-        {
-            value: 'yes-once',
-            label: 'Yes, just this time',
-            hint: applyHint,
-        },
-        {
-            value: 'yes-flex',
-            label: multipleAgents
-                ? "Yes, always (I'll pick the agent each run)"
-                : 'Yes, always',
-            hint: rememberHint,
-        },
-        ...pinChoice,
-        { value: 'no-once', label: 'No, just this time', hint: skipHint },
-        { value: 'no-never', label: 'No, never', hint: rememberHint },
-    ];
-    // Blank line keeps the prompt from gluing to the previous `npm install`
-    // output or any earlier orchestrator line.
-    console.log();
-    // Each choice's hint renders beside it, so the description no longer needs a
-    // footer that tracks the cursor.
-    const choice = await (0, safe_prompt_1.migrateChoice)({
-        message: 'Enable the agentic flow?',
-        choices,
-    });
-    (0, migrate_analytics_1.reportMigratePrompt)('agentic', choice);
-    switch (choice) {
-        case 'yes-once':
-            return { enabled: true };
-        case 'yes-flex':
-            return { enabled: true, persist: true };
-        case 'yes-pin':
-            return { enabled: true, persist: 'pin' };
-        case 'no-never':
-            return { enabled: false, persist: false };
-        case 'no-once':
-        default:
-            return { enabled: false };
-    }
-}
-// Persists the user's agentic choice to `nx.json` so the up-front prompt is
-// skipped on future runs. Edits the raw file in place via jsonc-parser, so it
-// touches only the `migrate.agentic` key and preserves comments, formatting,
-// and any `extends` preset (the prompt fires mid-migration, so a silent
-// reformat would be surprising). Never throws - a failed write only costs the
-// user the prompt again next time.
-function persistAgenticChoice(value) {
-    const nxJsonPath = (0, path_1.join)(workspace_root_1.workspaceRoot, 'nx.json');
-    if (!(0, fs_1.existsSync)(nxJsonPath)) {
-        output_1.output.warn({
-            title: `Could not save your agentic choice: no nx.json found at the workspace root.`,
-        });
-        return;
-    }
-    try {
-        const content = (0, fs_1.readFileSync)(nxJsonPath, 'utf-8');
-        const edits = (0, jsonc_parser_1.modify)(content, ['migrate', 'agentic'], value, {
-            formattingOptions: { insertSpaces: true, tabSize: 2 },
-        });
-        (0, fs_1.writeFileSync)(nxJsonPath, (0, jsonc_parser_1.applyEdits)(content, edits));
-        output_1.output.log({
-            title: `Saved your choice to nx.json (migrate.agentic = ${JSON.stringify(value)}). Nx won't ask again.`,
-        });
-    }
-    catch (e) {
-        output_1.output.warn({
-            title: `Could not save your agentic choice to nx.json: ${e instanceof Error ? e.message : String(e)}`,
-        });
-    }
-}
-async function selectAgent(detected, explicitId, isInteractive) {
-    if (explicitId) {
-        const match = detected.find((d) => d.id === explicitId);
-        if (match) {
-            return match;
-        }
-        // The requested agent isn't installed. Rather than aborting the migration,
-        // warn and fall through to resolve from the agents that ARE installed
-        // (pick when 2+, auto-select the only one, error only when none exist).
-        if (detected.length > 0) {
-            output_1.output.warn({
-                title: `The requested agent "${explicitId}" is not installed; using the installed agent(s) instead.`,
-                bodyLines: [
-                    'Currently installed agents:',
-                    ...detected.map((d) => `  - ${d.displayName} (${d.id})`),
-                ],
-            });
-        }
-    }
-    if (detected.length === 0) {
-        output_1.output.error({
-            title: 'Agentic flow was enabled, but no supported AI agent is installed on this machine.',
-            bodyLines: INSTALL_SUPPORTED_AGENTS_HINT,
-        });
-        throw new Error('No installed AI agent available.');
-    }
-    if (detected.length === 1) {
-        const only = detected[0];
-        output_1.output.log({
-            title: `Using ${only.displayName} for the agentic flow.`,
-        });
-        return only;
-    }
-    // 2+ detected. The picker only fires interactively. We've already required
-    // a TTY before resolving an enabled state, so this is defense-in-depth.
-    requireInteractiveOrAbort(isInteractive);
-    // Blank line keeps the prompt from gluing to the preceding output.
-    console.log();
-    const id = await (0, safe_prompt_1.migrateChoice)({
-        message: 'Multiple AI agents detected. Which one should Nx use?',
-        choices: detected.map((d) => ({ value: d.id, label: d.displayName })),
-    });
-    (0, migrate_analytics_1.reportMigratePrompt)('agent_select', id);
-    return detected.find((d) => d.id === id);
-}

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

@@ -1,132 +0,0 @@
-import type { AgentId } from './cli-args';
-export type { AgentId };
-/**
- * Workspace-relative directory holding all migrate-run scratch: a run
- * directory per run id. Shared by the run-dir layout in `handoff.ts` and the
- * agent permission rules in `definitions.ts` so the pre-authorized write scope
- * can't drift from the actual layout. It lives here so `definitions.ts`,
- * loaded whenever the agentic flow is resolved, doesn't pull in the handoff
- * runtime for the path alone.
- */
-export declare const MIGRATE_RUNS_RELATIVE_DIR = ".nx/migrate-runs";
-/**
- * The one subtree of a run directory an agent writes: its handoff files.
- * Everything beside it is state Nx owns and reads back, the orchestrator's
- * run state and plan snapshots included, so the pre-authorized write scope
- * stops at this segment. Package names make up the rest of a handoff path,
- * so without it they would occupy the run directory's top level and leave Nx
- * no name it could add there safely.
- */
-export declare const HANDOFFS_DIR_NAME = "handoffs";
-export declare function isHandoffGitignoreMigration(m: {
-    package: string;
-    name: string;
-}): boolean;
-/**
- * A coding agent that was found on the user's machine, ready to be spawned.
- *
- * Produced by `detect-installed.ts`. The `binary` is an absolute path so the
- * runner can spawn it directly without re-resolving against PATH.
- */
-export interface DetectedInstalledAgent {
-    id: AgentId;
-    displayName: string;
-    binary: string;
-    source: 'path' | 'well-known';
-}
-/**
- * Inputs the runner provides when asking an agent definition to build its
- * spawn arguments. Kept minimal — agent-specific quirks (e.g. transient agent
- * name for OpenCode) are encoded inside the definition, not here.
- */
-export interface InvocationContext {
-    systemContext: string;
-    userPrompt: string;
-    workspaceRoot: string;
-    /**
-     * Name of the run directory under `MIGRATE_RUNS_RELATIVE_DIR` holding this
-     * invocation's handoff. A workspace can carry several run directories at
-     * once, so a definition that pre-authorizes the handoff write narrows it to
-     * this one: the others belong to runs this invocation is not executing.
-     */
-    runDirName: string;
-}
-/**
- * What an agent definition returns from `buildInteractive`. The runner combines
- * this with the detected binary path to actually spawn.
- */
-export interface InvocationSpec {
-    args: string[];
-    env?: NodeJS.ProcessEnv;
-    cwd?: string;
-}
-/**
- * Static description of an agent the migrate command knows how to dispatch to.
- */
-export interface AgentDefinition {
-    id: AgentId;
-    displayName: string;
-    /** Binary names to probe via `which` (PATHEXT handled by `which` on Windows). */
-    binaryNames: string[];
-    /** Absolute paths to probe as a fallback when PATH lookup misses. */
-    wellKnownPaths(): string[];
-    buildInteractive(ctx: InvocationContext): InvocationSpec;
-}
-/**
- * Output of the agent's handoff file, written at the end of an agentic step.
- * The two locked fields drive the failure-handling matrix in the design doc;
- * extra fields are tolerated and surfaced via `extras`.
- */
-export interface HandoffFile {
-    status: 'success' | 'failed';
-    summary: string;
-    extras?: Record<string, unknown>;
-}
-/**
- * Outcome the runner reports back to the migrate orchestrator after a single
- * agentic step. The four kinds mirror the (a)/(b)/(c) matrix plus the user's
- * choice when (c) fires.
- *
- * `ambiguous-abort.causeSummary`: pre-rendered explanation lines. Populated
- * when Ctrl+C bypasses the ambiguous prompt (so the cause was never shown
- * inline) and forwarded so the caller can surface it. Omitted when the user
- * chose "abort" at the prompt — the cause was already shown there.
- */
-export type HandoffOutcome = {
-    kind: 'success';
-    summary: string;
-    extras?: Record<string, unknown>;
-} | {
-    kind: 'failed';
-    summary: string;
-    extras?: Record<string, unknown>;
-} | {
-    kind: 'ambiguous-continue';
-} | {
-    kind: 'ambiguous-abort';
-    causeSummary?: string[];
-};
-/**
- * Result of the up-front resolution phase, run once per run-phase invocation
- * and applied to every migration it covers.
- *
- * - `inside-agent`: nx detected it is itself running inside another agent;
- *   every agentic step is skipped and prompt migrations are surfaced for the
- *   outer agent to apply.
- * - `disabled`: the user opted out (explicit `--agentic=false`, declined the
- *   up-front prompt, or non-TTY without the flag).
- * - `enabled`: the agentic flow runs and `selectedAgent` is the agent it
- *   dispatches to.
- */
-export type ResolvedAgentic = {
-    kind: 'inside-agent';
-} | {
-    kind: 'disabled';
-} | {
-    kind: 'enabled';
-    selectedAgent: DetectedInstalledAgent;
-};
-/** The `enabled` variant, useful for narrowed function signatures. */
-export type EnabledResolvedAgentic = Extract<ResolvedAgentic, {
-    kind: 'enabled';
-}>;

package/dist/src/command-line/migrate/agentic/types.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HANDOFFS_DIR_NAME = exports.MIGRATE_RUNS_RELATIVE_DIR = void 0;
-exports.isHandoffGitignoreMigration = isHandoffGitignoreMigration;
-/**
- * Workspace-relative directory holding all migrate-run scratch: a run
- * directory per run id. Shared by the run-dir layout in `handoff.ts` and the
- * agent permission rules in `definitions.ts` so the pre-authorized write scope
- * can't drift from the actual layout. It lives here so `definitions.ts`,
- * loaded whenever the agentic flow is resolved, doesn't pull in the handoff
- * runtime for the path alone.
- */
-exports.MIGRATE_RUNS_RELATIVE_DIR = '.nx/migrate-runs';
-/**
- * The one subtree of a run directory an agent writes: its handoff files.
- * Everything beside it is state Nx owns and reads back, the orchestrator's
- * run state and plan snapshots included, so the pre-authorized write scope
- * stops at this segment. Package names make up the rest of a handoff path,
- * so without it they would occupy the run directory's top level and leave Nx
- * no name it could add there safely.
- */
-exports.HANDOFFS_DIR_NAME = 'handoffs';
-/**
- * Composite identity of the v23 migration that adds `.nx/migrate-runs` to
- * `.gitignore`. Hard-coded because the agentic preflight is a deliberate
- * one-off coupling: this exact migration owns the entry that keeps
- * `.nx/migrate-runs/<run-id>/...` scratch out of per-migration commits. If
- * the migration is ever renamed, this entry must move with it. It lives here
- * rather than in `handoff-gitignore.ts` so `sortMigrations`' hoist check
- * doesn't load that module's migration-execution machinery.
- */
-const HANDOFF_GITIGNORE_MIGRATION_PACKAGE = 'nx';
-const HANDOFF_GITIGNORE_MIGRATION_NAME = '23-0-0-add-migrate-runs-to-git-ignore';
-function isHandoffGitignoreMigration(m) {
-    return (m.package === HANDOFF_GITIGNORE_MIGRATION_PACKAGE &&
-        m.name === HANDOFF_GITIGNORE_MIGRATION_NAME);
-}

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

@@ -1,53 +0,0 @@
-import { CommandModule } from 'yargs';
-import type { AgenticArg } from './agentic/select';
-import { type StepAction } from './step-actions';
-export declare const yargsMigrateCommand: CommandModule;
-export declare const yargsInternalMigrateCommand: CommandModule;
-export declare const DEFAULT_MIGRATION_COMMIT_PREFIX = "chore: [nx migration] ";
-/** Allowed values for `--include` / `migrate.include`. */
-export declare const MIGRATE_INCLUDE_VALUES: readonly ['required', 'optional', 'all'];
-export type MigrateInclude = (typeof MIGRATE_INCLUDE_VALUES)[number];
-/** Allowed values for `--multi-major-mode` / `migrate.multiMajorMode`. */
-export declare const MULTI_MAJOR_MODES: readonly ['direct', 'gradual'];
-export type MultiMajorMode = (typeof MULTI_MAJOR_MODES)[number];
-/**
- * The `nx migrate` args bag. Types the keys the nx.json overlay and the
- * commit-prefix invariant read/write; the index signature keeps the rest of
- * the yargs args flowing through untouched.
- */
-export interface MigrateArgs {
-    packageAndVersion?: string;
-    runMigrations?: string;
-    runMigration?: string;
-    runId?: string;
-    stepAction?: StepAction;
-    include?: MigrateInclude;
-    /**
-     * nx.json `migrate.include` default. Consumed by `resolveInclude` only when the
-     * resolved target supports optional updates; kept separate from `include` so it is never
-     * mistaken for an explicit `--include` (which hard-fails when the target does
-     * not support optional updates).
-     */
-    includeFromConfig?: MigrateInclude;
-    multiMajorMode?: MultiMajorMode;
-    createCommits?: boolean;
-    commitPrefix?: string;
-    agentic?: AgenticArg;
-    validate?: boolean;
-    ifExists?: boolean;
-    interactive?: boolean;
-    [key: string]: any;
-}
-/**
- * Whether a custom commit prefix would be silently ignored: commits aren't
- * enabled and the agentic flow can't enable them either. Shared by the yargs
- * `.check()` (CLI args) and the nx.json overlay (merged args) so the rule lives
- * in one place. `agentic` may flip commits on by default, so a configured
- * agentic value (other than `false`, and not paired with `--no-create-commits`)
- * keeps the prefix in play.
- */
-export declare function customCommitPrefixHasNoEffect(args: {
-    createCommits: boolean | undefined;
-    commitPrefix: string | undefined;
-    agentic: unknown;
-}): boolean;

package/dist/src/command-line/migrate/command-object.js

@@ -1,152 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MULTI_MAJOR_MODES = exports.MIGRATE_INCLUDE_VALUES = exports.DEFAULT_MIGRATION_COMMIT_PREFIX = exports.yargsInternalMigrateCommand = exports.yargsMigrateCommand = void 0;
-exports.customCommitPrefixHasNoEffect = customCommitPrefixHasNoEffect;
-const handle_import_1 = require("../../utils/handle-import");
-const documentation_1 = require("../yargs-utils/documentation");
-const shared_options_1 = require("../yargs-utils/shared-options");
-const cli_args_1 = require("./agentic/cli-args");
-const step_actions_1 = require("./step-actions");
-exports.yargsMigrateCommand = {
-    command: 'migrate [packageAndVersion]',
-    describe: `Creates a migrations file or runs migrations from the migrations file.
-  - Migrate packages and create migrations.json (e.g., nx migrate @nx/workspace@latest)
-  - Run migrations (e.g., nx migrate --run-migrations=migrations.json). Use flag --if-exists to run migrations only if the migrations file exists.
-  - Run a single migration from migrations.json by id (e.g., nx migrate --run-migration=@nx/js:my-migration).`,
-    builder: (yargs) => (0, documentation_1.linkToNxDevAndExamples)(withMigrationOptions(yargs), 'migrate'),
-    handler: async () => process.exit(await (await (0, handle_import_1.handleImport)('./migrate.js', __dirname)).runMigration()),
-};
-exports.yargsInternalMigrateCommand = {
-    command: '_migrate [packageAndVersion]',
-    describe: false,
-    builder: (yargs) => withMigrationOptions(yargs),
-    handler: async (args) => process.exit(await (await (0, handle_import_1.handleImport)('./migrate.js', __dirname)).migrate(process.cwd(), args, process.argv.slice(3))),
-};
-exports.DEFAULT_MIGRATION_COMMIT_PREFIX = 'chore: [nx migration] ';
-/** Allowed values for `--include` / `migrate.include`. */
-exports.MIGRATE_INCLUDE_VALUES = ['required', 'optional', 'all'];
-/** Allowed values for `--multi-major-mode` / `migrate.multiMajorMode`. */
-exports.MULTI_MAJOR_MODES = ['direct', 'gradual'];
-/**
- * Whether a custom commit prefix would be silently ignored: commits aren't
- * enabled and the agentic flow can't enable them either. Shared by the yargs
- * `.check()` (CLI args) and the nx.json overlay (merged args) so the rule lives
- * in one place. `agentic` may flip commits on by default, so a configured
- * agentic value (other than `false`, and not paired with `--no-create-commits`)
- * keeps the prefix in play.
- */
-function customCommitPrefixHasNoEffect(args) {
-    const agenticMayEnableCommits = args.agentic !== undefined &&
-        args.agentic !== false &&
-        args.createCommits !== false;
-    return (args.createCommits !== true &&
-        !agenticMayEnableCommits &&
-        args.commitPrefix !== undefined &&
-        args.commitPrefix !== exports.DEFAULT_MIGRATION_COMMIT_PREFIX);
-}
-function withMigrationOptions(yargs) {
-    return (0, shared_options_1.withVerbose)(yargs)
-        .positional('packageAndVersion', {
-        describe: `The target package and version (e.g, @nx/workspace@16.0.0).`,
-        type: 'string',
-    })
-        .option('runMigrations', {
-        describe: `Execute migrations from a file (when the file isn't provided, execute migrations from migrations.json).`,
-        type: 'string',
-    })
-        .option('runMigration', {
-        describe: "Run a single migration from migrations.json by id. The id is '<package>:<name>'; a bare '<name>' is accepted when it matches exactly one migration. A name that contains ':' must use the full '<package>:<name>' form.",
-        type: 'string',
-    })
-        .option('runId', {
-        // Hidden with the orchestrator itself.
-        describe: 'The orchestrated migrate run to record a single migration into, or to reconcile when given without --run-migration.',
-        type: 'string',
-        hidden: true,
-    })
-        .option('stepAction', {
-        describe: 'How an orchestrated reconcile resolves its single failed or died step.',
-        choices: step_actions_1.STEP_ACTIONS,
-        type: 'string',
-        hidden: true,
-    })
-        .option('ifExists', {
-        describe: `Run migrations only if the migrations file exists, if not continues successfully.`,
-        type: 'boolean',
-        default: false,
-    })
-        .option('from', {
-        describe: 'Use the provided versions for packages instead of the ones installed in node_modules (e.g., --from="@nx/react@16.0.0,@nx/js@16.0.0").',
-        type: 'string',
-    })
-        .option('to', {
-        describe: 'Use the provided versions for packages instead of the ones calculated by the migrator (e.g., --to="@nx/react@16.0.0,@nx/js@16.0.0").',
-        type: 'string',
-    })
-        .option('createCommits', {
-        describe: 'Automatically create a git commit after each migration runs.',
-        type: 'boolean',
-        alias: ['C'],
-    })
-        .option('commitPrefix', {
-        describe: 'Commit prefix to apply to the commit for each migration, when --create-commits is enabled.',
-        type: 'string',
-        default: exports.DEFAULT_MIGRATION_COMMIT_PREFIX,
-    })
-        .option('interactive', {
-        describe: "Enable confirmation prompts for collecting optional package updates and migrations. Deprecated and slated for removal in Nx v24. Use '--include' instead. The flag stays valid for other interactive prompts.",
-        type: 'boolean',
-    })
-        .option('excludeAppliedMigrations', {
-        describe: 'Exclude migrations that should have been applied on previous updates. To be used with --from.',
-        type: 'boolean',
-        default: false,
-    })
-        .option('skipInstall', {
-        describe: 'Skip installing packages before running migrations. Useful when the installation needs to be performed manually (e.g., to resolve peer dependency conflicts).',
-        type: 'boolean',
-        default: false,
-    })
-        .option('include', {
-        describe: "Restrict which packages to migrate. Only applies when the target package supports optional updates. 'required' processes only the target package and the related packages it ships with; 'optional' processes only the optional dependency updates those packages recommend, catching up on any that may have been skipped previously; 'all' processes everything. When the target supports optional updates in an interactive terminal, prompts for the value if not provided; otherwise defaults to 'all'.",
-        type: 'string',
-        choices: exports.MIGRATE_INCLUDE_VALUES,
-    })
-        .option('multiMajorMode', {
-        describe: "Skip the multi-major migration prompt/warning and pick how to handle the jump. 'direct' migrates straight to the requested target. 'gradual' migrates to the smallest recommended step (re-run `nx migrate` to continue toward the original target). Equivalent env var: NX_MULTI_MAJOR_MODE=direct|gradual.",
-        type: 'string',
-        choices: exports.MULTI_MAJOR_MODES,
-    })
-        .option('agentic', {
-        describe: 'Enable the agentic flow for prompt-based migrations and AI-driven review. Pass `--agentic=<agent>` to pin a specific agent (claude-code, codex, or opencode). Pass `--agentic=false` or `--no-agentic` to disable.',
-        coerce: cli_args_1.coerceAgenticArg,
-    })
-        .option('validate', {
-        describe: 'When `--agentic` resolves to an enabled agent, run agent-driven validation after generator-only migrations that have no `prompt:` field. Defaults to on; pass `--no-validate` to opt out. Has no effect when `--agentic` is disabled, when running inside an outer agent, or when running non-interactively without an explicit agent.',
-        type: 'boolean',
-    })
-        .check(({ createCommits, commitPrefix, from, excludeAppliedMigrations, include, agentic, }) => {
-        // Only an explicit `--no-create-commits` is decidable here, before the
-        // nx.json overlay runs: an explicit `false` can't be rescued by nx.json
-        // (the CLI flag wins, and the agentic flow can't enable commits when
-        // they're explicitly off). When `createCommits` is undefined, nx.json
-        // may still enable commits, so defer to the post-overlay
-        // `assertCommitPrefixHasCommits` check.
-        if (createCommits === false &&
-            customCommitPrefixHasNoEffect({
-                createCommits,
-                commitPrefix,
-                agentic,
-            })) {
-            throw new Error('Error: Providing a custom commit prefix requires --create-commits to be enabled');
-        }
-        if (excludeAppliedMigrations && !from && include !== 'optional') {
-            throw new Error('Error: Excluding migrations that should have been previously applied requires --from to be set');
-        }
-        if (typeof agentic === 'string' &&
-            !cli_args_1.AGENT_IDS.includes(agentic)) {
-            throw new Error(`Error: Invalid --agentic value "${agentic}". Allowed: ${cli_args_1.AGENT_IDS.join(', ')}, true, false.`);
-        }
-        return true;
-    });
-}