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

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

@@ -1,317 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setMigrateInclude = setMigrateInclude;
-exports.setMigrateIncludeSource = setMigrateIncludeSource;
-exports.classifyMigrateFetchFallback = classifyMigrateFetchFallback;
-exports.reportMigratePrompt = reportMigratePrompt;
-exports.reportMigrateGenerateStart = reportMigrateGenerateStart;
-exports.reportMigrateGenerateComplete = reportMigrateGenerateComplete;
-exports.reportMigrateGenerateError = reportMigrateGenerateError;
-exports.reportMigrateRunStart = reportMigrateRunStart;
-exports.hasMigrateRunStarted = hasMigrateRunStarted;
-exports.reportMigrateRunComplete = reportMigrateRunComplete;
-exports.reportMigrateRunError = reportMigrateRunError;
-exports.reportMigrateOrchestratorInit = reportMigrateOrchestratorInit;
-exports.reportMigrateOrchestratorDispense = reportMigrateOrchestratorDispense;
-exports.reportMigrateOrchestratorComplete = reportMigrateOrchestratorComplete;
-exports.reportMigrateSingleMigrationInvocation = reportMigrateSingleMigrationInvocation;
-exports.computeMajorsCrossed = computeMajorsCrossed;
-exports.safeReport = safeReport;
-const semver_1 = require("semver");
-const analytics_1 = require("../../analytics");
-const provenance_1 = require("../../utils/provenance");
-const workspace_root_1 = require("../../utils/workspace-root");
-// Identifier-shaped tokens only (Node codes like ENOENT, class names like
-// TypeError). Rejects anything with a slash, space, or punctuation so a
-// settable `.code`/`.name` can't smuggle a path or message into GA.
-const IDENTIFIER_SHAPE = /^[A-Za-z][A-Za-z0-9_]*$/;
-// Context collected across the flow and folded into the completion/error
-// events. `_migrate` executes a single migrate invocation per process, so
-// module state is safe.
-let resolvedInclude;
-let includeSource;
-let generateErrorRecorded = false;
-let runErrorRecorded = false;
-let runStarted = false;
-function setMigrateInclude(include) {
-    resolvedInclude = include;
-}
-function setMigrateIncludeSource(source) {
-    includeSource = source;
-}
-function classifyMigrateFetchFallback(error) {
-    if (error instanceof provenance_1.ProvenanceError) {
-        return 'provenance';
-    }
-    if (error instanceof Error &&
-        error.message.includes('is not supported from')) {
-        return 'unsupported-registry';
-    }
-    return 'registry-error';
-}
-/**
- * Records an interactive migrate prompt and the user's selection.
- *
- * The prompt identity is encoded in the event name (`migrate_prompt_<prompt>`)
- * so it doesn't cost a GA custom dimension; `choice` is one dimension
- * multiplexed across all prompts, read conditioned on the event name. The
- * per-prompt value-spaces are typed in {@link MigratePromptChoices}.
- */
-function reportMigratePrompt(prompt, choice) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        (0, analytics_1.reportEvent)(`migrate_prompt_${prompt}`, {
-            [analytics_1.customDimensions.promptChoice]: choice,
-        });
-    });
-}
-function reportMigrateGenerateStart(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        (0, analytics_1.reportEvent)('migrate_generate_start', {
-            // Resolved migration target (defaults to `nx`; only an explicit
-            // non-first-party target is third-party). Reported raw per the `nx add`
-            // precedent - it's the chosen target, not a transitive dep like
-            // `run_error`'s `migration_name`, so there's no dependency-graph leak.
-            [analytics_1.customDimensions.packageName]: opts.targetPackage,
-            [analytics_1.customDimensions.cliSource]: cliSource(),
-            [analytics_1.customDimensions.interactive]: opts.interactive,
-            [analytics_1.customDimensions.excludeAppliedMigrations]: opts.excludeAppliedMigrations,
-        });
-    });
-}
-function reportMigrateGenerateComplete(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        const majorsCrossed = computeMajorsCrossed(opts.installedTargetVersion, opts.requestedTargetVersion);
-        const { registryCount = 0, installCount = 0 } = opts.fetchStats ?? {};
-        const fetchMethod = registryCount > 0 && installCount > 0
-            ? 'mixed'
-            : installCount > 0
-                ? 'install'
-                : registryCount > 0
-                    ? 'registry'
-                    : undefined;
-        (0, analytics_1.reportEvent)('migrate_generate_complete', {
-            [analytics_1.customDimensions.packageVersion]: opts.targetVersion,
-            [analytics_1.customDimensions.include]: opts.include,
-            [analytics_1.customDimensions.includeSource]: includeSource,
-            [analytics_1.customDimensions.majorsCrossed]: majorsCrossed,
-            // Only meaningful when the multi-major gate (2+ majors) applied.
-            ...(majorsCrossed !== undefined &&
-                majorsCrossed >= 2 &&
-                opts.multiMajorChoice
-                ? { [analytics_1.customDimensions.multiMajorChoice]: opts.multiMajorChoice }
-                : {}),
-            [analytics_1.customDimensions.fetchMethod]: fetchMethod,
-            [analytics_1.customDimensions.fetchFallbackReason]: opts.fetchStats?.fallbackReason,
-        });
-    });
-}
-function reportMigrateGenerateError(code, error) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions || generateErrorRecorded)
-            return;
-        generateErrorRecorded = true;
-        // The failing phase is encoded in the event name so it doesn't cost a GA
-        // custom dimension.
-        (0, analytics_1.reportEvent)(`migrate_generate_error_${code}`, {
-            // Populated only when include resolution had already happened when the
-            // failure occurred; earlier failures leave these undefined.
-            [analytics_1.customDimensions.include]: resolvedInclude,
-            [analytics_1.customDimensions.includeSource]: includeSource,
-            [analytics_1.customDimensions.errorName]: errorName(error),
-            [analytics_1.customDimensions.errorLocation]: errorLocation(error),
-        });
-    });
-}
-function reportMigrateRunStart(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        runStarted = true;
-        // No cli_source here: the run phase always executes from the local
-        // installation (the temp-install process re-dispatches before this point).
-        (0, analytics_1.reportEvent)('migrate_run_start', {
-            [analytics_1.customDimensions.createCommits]: opts.createCommits,
-            [analytics_1.customDimensions.migrationCount]: opts.migrationCount,
-        });
-    });
-}
-/**
- * Whether the current process recorded a `migrate_run_start` event. Lets
- * shared code paths (e.g. `executeMigrations`, reused by `nx repair`) skip
- * migrate events when not running inside a migrate run.
- */
-function hasMigrateRunStarted() {
-    return runStarted;
-}
-function reportMigrateRunComplete(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        (0, analytics_1.reportEvent)('migrate_run_complete', {
-            [analytics_1.customDimensions.agenticOutcome]: opts.agenticOutcome,
-            [analytics_1.customDimensions.agentUsed]: opts.agentUsed,
-            [analytics_1.customDimensions.migrationCount]: opts.migrationCount,
-            [analytics_1.customDimensions.appliedCount]: opts.appliedCount,
-        });
-    });
-}
-function reportMigrateRunError(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions || runErrorRecorded)
-            return;
-        runErrorRecorded = true;
-        // The failing step is encoded in the event name so it doesn't cost a GA
-        // custom dimension.
-        (0, analytics_1.reportEvent)(`migrate_run_error_${opts.code}`, {
-            // Third-party migration names can reveal private packages; only report
-            // first-party ones.
-            ...(opts.migrationPackage &&
-                opts.migrationName &&
-                isFirstPartyMigrationPackage(opts.migrationPackage)
-                ? {
-                    [analytics_1.customDimensions.migrationName]: `${opts.migrationPackage}:${opts.migrationName}`,
-                }
-                : {}),
-            [analytics_1.customDimensions.migrationCount]: opts.migrationCount,
-            [analytics_1.customDimensions.errorName]: opts.error !== undefined ? errorName(opts.error) : undefined,
-            [analytics_1.customDimensions.errorLocation]: opts.error !== undefined ? errorLocation(opts.error) : undefined,
-        });
-    });
-}
-function reportMigrateOrchestratorInit(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        (0, analytics_1.reportEvent)('migrate_orchestrator_init', {
-            [analytics_1.customDimensions.createCommits]: opts.createCommits,
-            [analytics_1.customDimensions.migrationCount]: opts.migrationCount,
-        });
-    });
-}
-/**
- * One event per orchestrator dispense. The `action` (dispense case) is a
- * closed enum carried on a reused dimension, read conditioned on the event
- * name (the same multiplexing pattern as {@link reportMigratePrompt});
- * `attempt` rides the migration-count dimension.
- */
-function reportMigrateOrchestratorDispense(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        (0, analytics_1.reportEvent)('migrate_orchestrator_dispense', {
-            [analytics_1.customDimensions.promptChoice]: opts.action,
-            [analytics_1.customDimensions.migrationCount]: opts.attempt,
-        });
-    });
-}
-/**
- * Terminal funnel event. The two step tallies and the total dispense count
- * ride reused numeric dimensions, read conditioned on the event name.
- */
-function reportMigrateOrchestratorComplete(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        (0, analytics_1.reportEvent)('migrate_orchestrator_complete', {
-            [analytics_1.customDimensions.appliedCount]: opts.completed,
-            [analytics_1.customDimensions.taskCount]: opts.skipped,
-            [analytics_1.customDimensions.migrationCount]: opts.dispenseCount,
-        });
-    });
-}
-/**
- * Counts invocations, not completions: emitted as soon as the migration id
- * resolves, while the worker can still stop before running anything.
- *
- * An invocation recorded into an orchestrated run (`--run-id`) gets its own
- * event name. Every other one keeps the name `--run-migration` shipped with,
- * so that series stays continuous for users who never enable the orchestrator.
- */
-function reportMigrateSingleMigrationInvocation(opts) {
-    safeReport(() => {
-        if (!analytics_1.customDimensions)
-            return;
-        (0, analytics_1.reportEvent)(opts.orchestrated
-            ? 'migrate_single_migration_recorded'
-            : 'migrate_single_migration_invocation', {
-            [analytics_1.customDimensions.promptChoice]: opts.migrationType,
-        });
-    });
-}
-// `_migrate` runs either from a temp install of the latest CLI or from the
-// workspace-local installation; same signal as the run-phase re-dispatch
-// check in migrate.ts.
-function cliSource() {
-    return __dirname.startsWith(workspace_root_1.workspaceRoot) ? 'local' : 'temp-latest';
-}
-// `coerce` tolerates ranges and partial versions from package.json entries
-// (e.g. `^21.0.0`); dist-tags that never resolved coerce to null.
-function computeMajorsCrossed(installed, target) {
-    const installedVersion = installed ? (0, semver_1.coerce)(installed) : null;
-    const targetVersion = target ? (0, semver_1.coerce)(target) : null;
-    if (!installedVersion || !targetVersion) {
-        return undefined;
-    }
-    return Math.max(0, targetVersion.major - installedVersion.major);
-}
-function isFirstPartyMigrationPackage(packageName) {
-    return (packageName === 'nx' ||
-        packageName.startsWith('@nx/') ||
-        packageName.startsWith('@nrwl/'));
-}
-// Structured error identity instead of the raw message: a Node system `code`
-// (ENOENT, ETIMEDOUT), else the constructor name (TypeError, ProvenanceError),
-// else the bare type. `.code`/`.name` are settable, so a migration could stuff
-// a path or message into them - only accept identifier-shaped tokens and fall
-// back to the bare type, so no free text reaches GA.
-function errorName(error) {
-    const code = error?.code;
-    if (typeof code === 'string' && IDENTIFIER_SHAPE.test(code)) {
-        return code;
-    }
-    if (error instanceof Error && IDENTIFIER_SHAPE.test(error.name)) {
-        return error.name;
-    }
-    return typeof error;
-}
-// Topmost stack frame inside a first-party package (nx, @nx/*, @nrwl/*),
-// package-qualified and relative to the package root (e.g.
-// `nx/src/command-line/migrate/migrate.js:1830:18`). The absolute prefix and
-// `dist/` are stripped so no user path leaks, and non-first-party frames are
-// skipped so a failing third-party migration can't surface a private package
-// path. Caveats: the topmost first-party frame may be a dispatcher rather than
-// the exact throw site, and (no shipped sourcemaps) the line:col is in the
-// compiled JS - so this locates against `nx_version`, not the TS source.
-function errorLocation(error) {
-    if (!(error instanceof Error) || !error.stack)
-        return undefined;
-    for (const line of error.stack.split('\n')) {
-        const match = line
-            .replace(/\\/g, '/')
-            .match(/\/node_modules\/((?:@(?:nx|nrwl)\/[^/]+|nx))\/(?:dist\/)?(src\/.+?:\d+:\d+)/);
-        if (match)
-            return `${match[1]}/${match[2]}`;
-    }
-    return undefined;
-}
-// Analytics is a secondary concern and must never interfere with the migrate
-// run. Swallow any failure while building params or emitting the event
-// (surfaced only under verbose logging), mirroring `trackEvent`/`flushAnalytics`
-// in `../../analytics`. Exported for callers whose param-building expressions
-// evaluate before the report function is entered.
-function safeReport(emit) {
-    try {
-        emit();
-    }
-    catch (e) {
-        if (process.env.NX_VERBOSE_LOGGING === 'true') {
-            console.log(`Failed to record migrate analytics event: ${e instanceof Error ? e.message : e}`);
-        }
-    }
-}

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

@@ -1,80 +0,0 @@
-import type { ResolvedAgentic } from './agentic/types';
-/**
- * Discriminated result for `commitMigrationIfRequested`. Distinguishes the
- * shapes the executor needs to react to:
- *
- * - `committed`: a commit landed. `sha` is `null` only when `git rev-parse
- *   HEAD` failed transiently — by contract the diff is no longer in the
- *   working tree.
- * - `no-changes`: commits were requested but there was nothing to commit.
- * - `failed`: the commit attempt itself errored. The diff remains in the
- *   working tree; the executor uses this signal to track pending migrations
- *   so the next successful commit can annotate its body.
- * - `disabled`: commits are off for this run.
- */
-export type CommitResult = {
-    status: 'committed';
-    sha: string | null;
-} | {
-    status: 'no-changes';
-} | {
-    status: 'failed';
-    reason: string;
-} | {
-    status: 'disabled';
-};
-/**
- * `pendingMigrations` are listed in the commit body so a `git log -p` reader
- * can see which earlier migrations' diffs this commit absorbed (their own
- * commits failed and `git add -A` picked their working-tree state up too).
- *
- * The default `failureGuidance` describes the classic loop's absorb-and-recap
- * behavior; a caller with no later commit or recap to absorb the diff (the
- * standalone single-migration worker) passes its own.
- */
-export declare function commitMigrationIfRequested(root: string, migration: {
-    name: string;
-}, shouldCreateCommits: boolean, commitPrefix: string, installDepsIfChanged: () => Promise<void>, pendingMigrations?: ReadonlyArray<{
-    package: string;
-    name: string;
-}>, failureGuidance?: string): Promise<CommitResult>;
-/**
- * Commits any pre-existing working-tree state into a dedicated "checkpoint"
- * commit before the first migration runs. Without this, the first migration's
- * commit would absorb whatever was already pending — most commonly the
- * package.json edit `nx migrate latest` produces and the lockfile churn from
- * the orchestrator's `npm install --ignore-scripts` step — and migration 1's
- * validation would see that mixed in with the generator output. No-op when
- * the working tree is already clean.
- */
-export declare function commitCheckpointBeforeMigrations(root: string, commitPrefix: string): void;
-/**
- * `agenticHasDiffContext` gates the agent prompt: without per-migration commits
- * to isolate a migration's diff, the prompt embeds a file list instead of
- * pointing at git.
- */
-export declare function resolveCreateCommits(args: {
-    createCommits: boolean | undefined;
-    mode: ResolvedAgentic['kind'] | 'orchestrated';
-    isGitRepo: boolean;
-    commitPrefixIsCustom?: boolean;
-}): {
-    effective: boolean;
-    agenticHasDiffContext: boolean;
-    warning?: string;
-    error?: string;
-};
-/**
- * Asks before a run starts committing on the workspace's default branch, and
- * reports the decision when the answer is no. Returns whether to proceed.
- *
- * Callers gate this on commits being effective and on prompting being
- * possible, so non-interactive runs (CI, `--no-interactive`) never reach here;
- * `confirmCommitsOnDefaultBranch` has no guard of its own and would block on a
- * prompt nobody can answer.
- */
-export declare function confirmMigrationCommitsOnDefaultBranch(root: string, whatWouldRun: 'running migrations' | 'running the migration'): Promise<boolean>;
-export declare function confirmCommitsOnDefaultBranch(args: {
-    currentBranch: string | null;
-    defaultBranch: string | null;
-}): Promise<boolean>;

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

@@ -1,217 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.commitMigrationIfRequested = commitMigrationIfRequested;
-exports.commitCheckpointBeforeMigrations = commitCheckpointBeforeMigrations;
-exports.resolveCreateCommits = resolveCreateCommits;
-exports.confirmMigrationCommitsOnDefaultBranch = confirmMigrationCommitsOnDefaultBranch;
-exports.confirmCommitsOnDefaultBranch = confirmCommitsOnDefaultBranch;
-const tslib_1 = require("tslib");
-const pc = tslib_1.__importStar(require("picocolors"));
-const configuration_1 = require("../../config/configuration");
-const command_line_utils_1 = require("../../utils/command-line-utils");
-const git_utils_1 = require("../../utils/git-utils");
-const logger_1 = require("../../utils/logger");
-const output_1 = require("../../utils/output");
-const types_1 = require("./agentic/types");
-const safe_prompt_1 = require("./safe-prompt");
-// `git add -A` captures an orchestrated run's scratch state whenever the
-// ignore rule that normally hides it goes missing mid-run (a checkout, a
-// .gitignore edit, or the migration's own changes).
-const MIGRATE_COMMIT_EXCLUDES = [types_1.MIGRATE_RUNS_RELATIVE_DIR];
-/**
- * `pendingMigrations` are listed in the commit body so a `git log -p` reader
- * can see which earlier migrations' diffs this commit absorbed (their own
- * commits failed and `git add -A` picked their working-tree state up too).
- *
- * The default `failureGuidance` describes the classic loop's absorb-and-recap
- * behavior; a caller with no later commit or recap to absorb the diff (the
- * standalone single-migration worker) passes its own.
- */
-async function commitMigrationIfRequested(root, migration, shouldCreateCommits, commitPrefix, installDepsIfChanged, pendingMigrations = [], failureGuidance = 'The next successful commit will absorb it and reference this migration in its body; if no later commit lands, the end-of-run output will list this migration so you can commit or revert manually.') {
-    if (!shouldCreateCommits)
-        return { status: 'disabled' };
-    await installDepsIfChanged();
-    // Generator may have only touched gitignored paths or the excluded scratch
-    // dir, or the prompt half made no change: log neutrally, not as an error.
-    // The probe excludes what the commit excludes, else the commit fails empty.
-    if (!(0, git_utils_1.hasUncommittedChanges)(root, MIGRATE_COMMIT_EXCLUDES)) {
-        logger_1.logger.info(pc.dim(`- No changes to commit for ${migration.name}.`));
-        return { status: 'no-changes' };
-    }
-    const commitMessage = buildCommitMessage(`${commitPrefix}${migration.name}`, pendingMigrations);
-    try {
-        const sha = (0, git_utils_1.tryCommitChanges)(commitMessage, root, MIGRATE_COMMIT_EXCLUDES);
-        if (sha)
-            return { status: 'committed', sha };
-        // null = commit landed but `git rev-parse HEAD` failed (see
-        // `tryCommitChanges`). Degraded-but-correct — log yellow, not red.
-        logger_1.logger.info(pc.yellow(`The commit for ${migration.name} was created, but its sha could not be resolved (\`git rev-parse HEAD\` failed transiently). Continuing without recording the sha for this step.`));
-        return { status: 'committed', sha: null };
-    }
-    catch (err) {
-        const reason = err instanceof Error ? err.message : String(err);
-        logger_1.logger.info(pc.red(`Could not create a commit for ${migration.name}:\n${reason}\nThe migration's diff remains in the working tree; inspect with \`git status\` / \`git diff\` to review. ${failureGuidance}`));
-        return { status: 'failed', reason };
-    }
-}
-// Migration names come from migrations.json (third-party plugin authored);
-// they cannot be trusted to be single-line. Strip CR/LF so a hostile name
-// cannot inject body lines or fake `Co-Authored-By:` / similar trailers.
-function sanitizeMigrationLine(value) {
-    return value.replace(/[\r\n]+/g, ' ').trim();
-}
-function buildCommitMessage(subject, pendingMigrations) {
-    if (pendingMigrations.length === 0)
-        return subject;
-    // Two newlines separate the subject from the body per the
-    // conventional-commits convention.
-    const lines = [
-        subject,
-        '',
-        'Includes changes from prior migrations whose own commits failed:',
-        ...pendingMigrations.map((p) => `  - ${sanitizeMigrationLine(p.package)}: ${sanitizeMigrationLine(p.name)}`),
-    ];
-    return lines.join('\n');
-}
-/**
- * Commits any pre-existing working-tree state into a dedicated "checkpoint"
- * commit before the first migration runs. Without this, the first migration's
- * commit would absorb whatever was already pending — most commonly the
- * package.json edit `nx migrate latest` produces and the lockfile churn from
- * the orchestrator's `npm install --ignore-scripts` step — and migration 1's
- * validation would see that mixed in with the generator output. No-op when
- * the working tree is already clean.
- */
-function commitCheckpointBeforeMigrations(root, commitPrefix) {
-    if (!(0, git_utils_1.hasUncommittedChanges)(root, MIGRATE_COMMIT_EXCLUDES))
-        return;
-    try {
-        const sha = (0, git_utils_1.tryCommitChanges)(`${commitPrefix}checkpoint before running migrations`, root, MIGRATE_COMMIT_EXCLUDES);
-        if (sha) {
-            logger_1.logger.info(pc.dim(`- Checkpoint commit created: ${sha}`));
-            return;
-        }
-        // null = commit landed but `git rev-parse HEAD` failed (see
-        // `tryCommitChanges`). State is captured, just unanchored.
-        output_1.output.warn({
-            title: 'Could not resolve checkpoint commit sha',
-            bodyLines: [
-                'The checkpoint commit was created, but its sha could not be resolved (`git rev-parse HEAD` failed transiently).',
-            ],
-        });
-    }
-    catch (err) {
-        const reason = err instanceof Error ? err.message : String(err);
-        output_1.output.warn({
-            title: 'Could not create checkpoint commit before migrations',
-            bodyLines: [
-                reason,
-                `Migration 1's commit will absorb any pre-existing working-tree state.`,
-            ],
-        });
-    }
-}
-/**
- * `agenticHasDiffContext` gates the agent prompt: without per-migration commits
- * to isolate a migration's diff, the prompt embeds a file list instead of
- * pointing at git.
- */
-function resolveCreateCommits(args) {
-    const { createCommits, mode, isGitRepo, commitPrefixIsCustom } = args;
-    // The orchestrator forces the agentic defaults without the `--agentic` flag,
-    // so its warnings must not name a flag the user never passed.
-    const orchestrated = mode === 'orchestrated';
-    const agenticKind = orchestrated ? 'enabled' : mode;
-    if (createCommits === true && !isGitRepo) {
-        return {
-            effective: false,
-            agenticHasDiffContext: false,
-            error: '`--create-commits` requires a git repository. Run `git init` first, or omit the flag.',
-        };
-    }
-    if (agenticKind === 'enabled') {
-        if (createCommits === false) {
-            return {
-                effective: false,
-                agenticHasDiffContext: false,
-                warning: (orchestrated
-                    ? "--no-create-commits was passed, but orchestrated migrate runs create per-migration commits by default. Without them, the agent can't isolate the current migration's changes from earlier migrations in this run. Drop --no-create-commits for accurate per-migration review."
-                    : "--no-create-commits was passed alongside --agentic. Without per-migration commits, the agent can't isolate the current migration's changes from earlier migrations in this run. Drop --no-create-commits for accurate per-migration review.") +
-                    (commitPrefixIsCustom
-                        ? ' Note: the custom --commit-prefix value will have no effect because commits are disabled.'
-                        : ''),
-            };
-        }
-        // Not an error like the explicit `--create-commits` branch above: the
-        // agentic default was never asked for, so degrade instead.
-        if (!isGitRepo) {
-            return {
-                effective: false,
-                agenticHasDiffContext: false,
-                warning: (orchestrated
-                    ? 'Orchestrated migrate runs create per-migration commits by default, but the workspace is not a git repository. Continuing without commits, so the agent will not receive per-file diff context. Run `git init` to enable.'
-                    : '`--agentic` enables per-migration commits by default, but the workspace is not a git repository. Continuing without commits, so the agent will not receive per-file diff context. Run `git init` to enable.') +
-                    (commitPrefixIsCustom
-                        ? ' The custom --commit-prefix value will have no effect.'
-                        : ''),
-            };
-        }
-        return { effective: true, agenticHasDiffContext: true };
-    }
-    return {
-        effective: createCommits === true,
-        agenticHasDiffContext: false,
-        warning: commitPrefixIsCustom && createCommits !== true
-            ? 'A custom migrate commit prefix is configured, but commits are not enabled for this run, so it has no effect. Set `migrate.createCommits` to `true` (or pass `--create-commits`) to create a commit per migration.'
-            : undefined,
-    };
-}
-// The branch to hold `getBaseRef`'s value against. It may name a remote-tracking
-// ref whose local counterpart drops the remote (the CI-workflow generator writes
-// `origin/<branch>`), yet a local branch can be named `up/feature` while `up` is
-// a remote, so an exact match wins before any stripping and the longest matching
-// remote wins after. `origin` counts even undeclared: the generator assumes it.
-function defaultBranchToCompare(baseRef, currentBranch, root) {
-    if (currentBranch === baseRef) {
-        return baseRef;
-    }
-    const remote = [...(0, git_utils_1.getGitRemoteNames)(root), 'origin']
-        .filter((name) => baseRef.startsWith(`${name}/`))
-        .sort((a, b) => b.length - a.length)[0];
-    return remote ? baseRef.slice(remote.length + 1) : baseRef;
-}
-/**
- * Asks before a run starts committing on the workspace's default branch, and
- * reports the decision when the answer is no. Returns whether to proceed.
- *
- * Callers gate this on commits being effective and on prompting being
- * possible, so non-interactive runs (CI, `--no-interactive`) never reach here;
- * `confirmCommitsOnDefaultBranch` has no guard of its own and would block on a
- * prompt nobody can answer.
- */
-async function confirmMigrationCommitsOnDefaultBranch(root, whatWouldRun) {
-    const currentBranch = (0, git_utils_1.getGitCurrentBranch)(root);
-    const proceed = await confirmCommitsOnDefaultBranch({
-        currentBranch,
-        defaultBranch: defaultBranchToCompare((0, command_line_utils_1.getBaseRef)((0, configuration_1.readNxJson)(root)), currentBranch, root),
-    });
-    if (!proceed) {
-        output_1.output.log({
-            title: `Skipped ${whatWouldRun} to avoid committing to the default branch '${currentBranch}'.`,
-            bodyLines: [
-                'Switch to a different branch and re-run, or re-run and confirm to proceed.',
-            ],
-        });
-    }
-    return proceed;
-}
-async function confirmCommitsOnDefaultBranch(args) {
-    const { currentBranch, defaultBranch } = args;
-    if (!currentBranch || !defaultBranch || currentBranch !== defaultBranch) {
-        return true;
-    }
-    return (0, safe_prompt_1.migrateConfirm)({
-        message: `You're on the default branch '${currentBranch}'. nx migrate will create a commit for each migration on this branch. Continue?`,
-        initial: false,
-    });
-}

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

@@ -1,29 +0,0 @@
-import type { NxMigrateConfiguration } from '../../config/nx-json';
-import { type MigrateArgs } from './command-object';
-/**
- * Overlays `nx.json` `migrate` defaults onto the raw CLI args: a CLI flag wins,
- * then `nx.json`, then the built-in default. Returns a new args object; the
- * input is not mutated.
- *
- * Phase-aware so each option is only filled where it is consumed, and so a
- * config value never trips the mutually-exclusive-flag guards in
- * `parseMigrationsOptions`: `include` and `multiMajorMode` in the generate
- * phase only; `createCommits` / `commitPrefix` and `agentic` / `validate` when
- * running the whole migrations file or a standalone single migration. A
- * `--run-id` invocation takes none of them: a recorded run takes its commit
- * config from run.json and is driven by the outer agent.
- *
- * `include` is carried as `includeFromConfig` so it is never mistaken for an
- * explicit `--include`: `resolveInclude` applies it only when the resolved
- * target supports optional updates.
- */
-export declare function applyNxJsonMigrateDefaults(args: MigrateArgs, migrateConfig: NxMigrateConfiguration | undefined, env?: NodeJS.ProcessEnv): MigrateArgs;
-/**
- * The single authority for the "a custom commit prefix needs commits enabled"
- * invariant. Run it against the final merged args (after
- * `applyNxJsonMigrateDefaults`): the yargs `.check()` only sees the CLI args,
- * but nx.json may enable commits via `createCommits` or `agentic`. The CLI
- * `.check()` only fast-fails the unrescuable explicit `--no-create-commits`
- * case; everything else is decided here.
- */
-export declare function assertCommitPrefixHasCommits(merged: MigrateArgs): void;