@ohos-ports/nx 23.3.0-beta.2 → 24.0.2-beta.0

package/dist/src/command-line/migrate/agentic/run-step.js

@@ -1,148 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAgenticPromptStep = runAgenticPromptStep;
-const tslib_1 = require("tslib");
-const path_1 = require("path");
-const pc = tslib_1.__importStar(require("picocolors"));
-const child_process_1 = require("../../../utils/child-process");
-const logger_1 = require("../../../utils/logger");
-const package_manager_1 = require("../../../utils/package-manager");
-const migrate_output_1 = require("../migrate-output");
-const format_command_1 = require("./format-command");
-const handoff_1 = require("./handoff");
-const instruction_files_1 = require("./instruction-files");
-const generic_validation_1 = require("./prompts/generic-validation");
-const hybrid_prompt_migration_1 = require("./prompts/hybrid-prompt-migration");
-const prompt_migration_1 = require("./prompts/prompt-migration");
-const system_prompt_1 = require("./prompts/system-prompt");
-const definitions_1 = require("./definitions");
-const runner_1 = require("./runner");
-const types_1 = require("./types");
-/**
- * Spawns the configured AI agent against a migration step, awaits its handoff,
- * and translates the outcome into a structured result the executor can branch
- * on. Throws on failure / abort; returns a result with `ambiguous` set when
- * the agent exited without writing a handoff and the user chose to continue.
- *
- * `installDepsIfChanged` is a callback rather than a `ChangedDepInstaller`
- * instance so this module stays decoupled from the executor's internal state.
- * The structural `migration` type captures only the fields read here, keeping
- * the file free of cross-imports with the orchestrator.
- */
-async function runAgenticPromptStep(input) {
-    const { root, migration, agentic, runDir, installDepsIfChanged, implContext, documentationPath, mode = 'author', } = input;
-    const handoffFilePath = (0, handoff_1.stepHandoffPath)(runDir, migration);
-    // The system prompt tells the agent the parent dir exists, so the agent
-    // doesn't defensively `mkdir -p` (which triggers a workspace-permission
-    // prompt in agents like Claude Code every run).
-    (0, handoff_1.mkdirSafely)((0, path_1.dirname)(handoffFilePath), `handoff directory for ${migration.name}`);
-    const pm = (0, package_manager_1.detectPackageManager)(root);
-    const pmCommand = (0, package_manager_1.getPackageManagerCommand)(pm, root);
-    const systemPrompt = (0, system_prompt_1.buildSystemPrompt)({
-        workspaceRoot: root,
-        handoffFileAbsolutePath: handoffFilePath,
-        packageManager: pm,
-        nxInvocation: (0, child_process_1.getRunNxBaseCommand)(pmCommand, root),
-        mode,
-        pmExec: pmCommand.exec,
-        // Validation prompts carry no format rule, so don't probe the workspace
-        // (detectFormatter can warn) for a command the prompt would discard.
-        formatCommand: mode === 'generic-validation'
-            ? null
-            : (0, format_command_1.resolveFormatCommand)(root, pmCommand.exec),
-    });
-    let userPrompt;
-    if (mode === 'generic-validation') {
-        if (!implContext) {
-            throw new Error(`Internal error: generic-validation mode requires impl context (logs, changes, agentContext, hasDiffContext) but none was provided.`);
-        }
-        userPrompt = (0, generic_validation_1.buildGenericValidationUserPrompt)({
-            package: migration.package,
-            name: migration.name,
-            version: migration.version,
-            description: migration.description,
-            handoffFileAbsolutePath: handoffFilePath,
-            documentationPath,
-            impl: implContext,
-        });
-    }
-    else {
-        const promptCtx = {
-            package: migration.package,
-            name: migration.name,
-            version: migration.version,
-            description: migration.description,
-            promptPath: migration.prompt,
-            handoffFileAbsolutePath: handoffFilePath,
-            documentationPath,
-        };
-        userPrompt = implContext
-            ? (0, hybrid_prompt_migration_1.buildHybridPromptUserPrompt)({ ...promptCtx, impl: implContext })
-            : (0, prompt_migration_1.buildPromptMigrationUserPrompt)(promptCtx);
-    }
-    const definition = (0, definitions_1.getAgentDefinition)(agentic.selectedAgent.id);
-    if (!definition) {
-        throw new Error(`No agent definition registered for "${agentic.selectedAgent.id}".`);
-    }
-    const { systemPromptFilePath, instructionsPointer } = (0, instruction_files_1.writeStepInstructionFiles)({
-        workspaceRoot: root,
-        runDir,
-        migration,
-        systemPrompt,
-        instructions: userPrompt,
-    });
-    const phase = mode === 'generic-validation' ? 'Validating' : 'Running prompt';
-    logger_1.logger.info(pc.dim(`→ ${phase} with ${agentic.selectedAgent.displayName}…`));
-    const outcome = await (0, runner_1.runAgentic)({
-        detected: agentic.selectedAgent,
-        definition,
-        invocationContext: {
-            systemPrompt,
-            systemPromptFilePath,
-            instructionsPointer,
-            inlineSystemContext: (0, system_prompt_1.buildInlineSystemContext)({
-                handoffFileAbsolutePath: handoffFilePath,
-                systemPromptFilePath,
-            }),
-            inlineSystemContextFallback: (0, system_prompt_1.buildMinimalSystemContext)(systemPromptFilePath),
-            workspaceRoot: root,
-            runDirName: (0, path_1.basename)(runDir),
-        },
-        handoffFilePath,
-        handoffsDir: (0, path_1.join)(runDir, types_1.HANDOFFS_DIR_NAME),
-    });
-    // Some agent TUIs leave cursor/SGR state behind on exit. Reset before our
-    // own log lines so the outcome line lands clean instead of overlaid on the
-    // agent's trailing status bar.
-    (0, migrate_output_1.resetSgrAfterAgent)();
-    switch (outcome.kind) {
-        case 'success':
-            await installDepsIfChanged();
-            return { summary: outcome.summary, ambiguous: false };
-        case 'ambiguous-continue':
-            await installDepsIfChanged();
-            return {
-                summary: 'No handoff file was written; marked complete by user.',
-                ambiguous: true,
-            };
-        case 'failed': {
-            const failLabel = mode === 'generic-validation' ? 'Validation failed' : 'Failed';
-            logger_1.logger.info(`${pc.red('✗')} ${failLabel}: ${outcome.summary}`);
-            throw new Error(`Prompt migration ${migration.package}: ${migration.name} failed.`);
-        }
-        case 'ambiguous-abort':
-            // When Ctrl+C masked an underlying crash, the runner forwards the
-            // pre-rendered cause lines so we surface them before "Aborted by
-            // user" — otherwise the user sees only "aborted" with no signal that
-            // anything also crashed. When the abort came from the user picking
-            // "abort" at the prompt, the cause was already shown there.
-            if (outcome.causeSummary && outcome.causeSummary.length > 0) {
-                logger_1.logger.info(pc.dim('The agent run ended without a usable handoff:'));
-                for (const line of outcome.causeSummary) {
-                    logger_1.logger.info(pc.dim(`  ${line}`));
-                }
-            }
-            logger_1.logger.info(`${pc.red('✗')} Aborted by user.`);
-            throw new Error(`Prompt migration ${migration.package}: ${migration.name} was aborted by user.`);
-    }
-}

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

@@ -1,21 +0,0 @@
-import { AgentDefinition, DetectedInstalledAgent, HandoffOutcome, InvocationContext } from './types';
-export interface RunAgenticArgs {
-    detected: DetectedInstalledAgent;
-    definition: AgentDefinition;
-    invocationContext: InvocationContext;
-    handoffFilePath: string;
-    /** Directory the handoff sits in; passing a parent instead skips the symlink guard. */
-    handoffsDir: string;
-    /** Override the handoff-file poll interval (test seam). */
-    handoffPollIntervalMs?: number;
-    /** Override the SIGINT-to-SIGKILL grace period (test seam). */
-    gracefulExitMs?: number;
-    /** Override the post-force-kill safety bound (test seam). */
-    forceKillWaitMs?: number;
-}
-/**
- * Spawns the selected agent with `stdio: 'inherit'`, swallows SIGINT while the
- * child is alive, waits for it to exit, and resolves the run's outcome from
- * the handoff file (or the user when the file is missing).
- */
-export declare function runAgentic(args: RunAgenticArgs): Promise<HandoffOutcome>;

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

@@ -1,262 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAgentic = runAgentic;
-const tslib_1 = require("tslib");
-const child_process_1 = require("child_process");
-const pc = tslib_1.__importStar(require("picocolors"));
-const logger_1 = require("../../../utils/logger");
-const output_1 = require("../../../utils/output");
-const migrate_analytics_1 = require("../migrate-analytics");
-const safe_prompt_1 = require("../safe-prompt");
-const close_agent_session_1 = require("./close-agent-session");
-const handoff_1 = require("./handoff");
-const terminal_repair_1 = require("./terminal-repair");
-const windows_cmd_1 = require("./windows-cmd");
-/**
- * Spawns the selected agent with `stdio: 'inherit'`, swallows SIGINT while the
- * child is alive, waits for it to exit, and resolves the run's outcome from
- * the handoff file (or the user when the file is missing).
- */
-async function runAgentic(args) {
-    const { detected, definition, invocationContext, handoffFilePath, handoffsDir, handoffPollIntervalMs, gracefulExitMs = close_agent_session_1.AGENT_GRACEFUL_EXIT_MS, forceKillWaitMs = close_agent_session_1.FORCE_KILL_WAIT_MS, } = args;
-    const adapted = adaptWithinCommandLineBudget(detected, definition, invocationContext);
-    let child;
-    // Local alias so `@nx/workspace-require-windows-hide` recognizes the
-    // options arg as a tracked Identifier rather than giving up on a
-    // member-expression skip — keeps the lint rule strict on other call sites.
-    const spawnOptions = adapted.options;
-    try {
-        child = (0, child_process_1.spawn)(adapted.binary, adapted.args, spawnOptions);
-    }
-    catch (err) {
-        return resolveFromHandoffOrPrompt(handoffFilePath, handoffsDir, false, {
-            spawnError: err instanceof Error ? err.message : String(err),
-        });
-    }
-    // Counts SIGINTs while the agent runs. Non-zero after exit means the
-    // user pressed Ctrl+C → skip the ambiguous abort/continue prompt. Prompting
-    // in the TTY state left by a SIGINT-killed child misbehaved under enquirer
-    // (ERR_USE_AFTER_CLOSE, setRawMode EIO) from async chains `await` could not
-    // catch. Whether @clack/prompts shares that fault is unverified, so the skip
-    // stays; reproducing it needs a real terminal.
-    let userInterruptCount = 0;
-    const swallowSigint = () => {
-        userInterruptCount++;
-    };
-    process.on('SIGINT', swallowSigint);
-    const handoffWatchAbort = new AbortController();
-    const exitPromise = (0, close_agent_session_1.waitForExit)(child);
-    const handoffPromise = (0, handoff_1.waitForValidHandoff)(handoffFilePath, handoffsDir, {
-        signal: handoffWatchAbort.signal,
-        intervalMs: handoffPollIntervalMs,
-    });
-    let exitInfo = {};
-    try {
-        const winner = await Promise.race([
-            exitPromise.then((info) => {
-                exitInfo = info;
-                return 'exit';
-            }),
-            // Rejection handler swallows the abort-triggered rejection from the
-            // `finally` block after the race has settled — otherwise Node logs it
-            // as an unhandled rejection.
-            handoffPromise.then(() => 'handoff', () => 'exit'),
-        ]);
-        if (winner === 'handoff') {
-            await (0, close_agent_session_1.closeAgentSession)(child, exitPromise, gracefulExitMs, forceKillWaitMs);
-            // Extra safety bound so the orchestrator can't hang if the child
-            // stays stuck after SIGKILL / taskkill (e.g. D-state on a hung NFS
-            // read, or taskkill returning before the process actually exits).
-            await (0, close_agent_session_1.raceWithTimeout)(exitPromise, forceKillWaitMs);
-        }
-    }
-    finally {
-        handoffWatchAbort.abort();
-        process.removeListener('SIGINT', swallowSigint);
-        (0, terminal_repair_1.restoreTermiosAfterAgent)();
-    }
-    return resolveFromHandoffOrPrompt(handoffFilePath, handoffsDir, userInterruptCount > 0, exitInfoToCause(exitInfo));
-}
-/**
- * Builds Windows shim arguments within budget, trying the shorter context
- * before aborting. Rejects overflow to avoid truncated instructions.
- * Leaves command lines unmeasured off the shim path.
- */
-function adaptWithinCommandLineBudget(detected, definition, invocationContext) {
-    const adapt = (ctx) => {
-        const spec = definition.buildInteractive(ctx);
-        return (0, windows_cmd_1.adaptSpawnForWindowsShim)(detected.binary, spec.args, {
-            stdio: 'inherit',
-            cwd: spec.cwd ?? ctx.workspaceRoot,
-            env: spec.env ? { ...process.env, ...spec.env } : process.env,
-            windowsHide: true,
-        });
-    };
-    const adapted = adapt(invocationContext);
-    if ((0, windows_cmd_1.withinCommandLineBudget)(adapted)) {
-        return adapted;
-    }
-    const reduced = adapt({
-        ...invocationContext,
-        inlineSystemContext: invocationContext.inlineSystemContextFallback,
-    });
-    if ((0, windows_cmd_1.withinCommandLineBudget)(reduced)) {
-        logger_1.logger.info(pc.dim(`  Passing the agent a reduced system context. The full one does not fit on a Windows command line alongside these paths.`));
-        return reduced;
-    }
-    output_1.output.error({
-        title: `${detected.displayName} cannot be started for this migration step`,
-        bodyLines: [
-            `Launching it needs a ${reduced.commandLineLength}-character command line. cmd.exe runs at most ${windows_cmd_1.WINDOWS_COMMAND_LINE_LIMIT} characters, and nx stops at ${windows_cmd_1.WINDOWS_COMMAND_LINE_BUDGET} to leave room for what it cannot measure from here.`,
-            `The length is paths: the workspace root, at ${invocationContext.workspaceRoot.length} characters, and the migration's package and name, each repeated across several of them.`,
-            ``,
-            `Re-run with \`--agentic=false\` to apply the remaining migrations yourself. Moving the workspace to a shorter path can help too, but only for agents that put it on the command line.`,
-        ],
-    });
-    throw new Error(`Cannot start ${detected.displayName}: the command line exceeds the Windows limit.`);
-}
-function exitInfoToCause(info) {
-    const cause = {};
-    // Include `code === 0` so the prompt can distinguish "agent exited cleanly
-    // without writing a handoff" (likely the user closed the agent on purpose,
-    // or the agent terminated without invoking the handoff step) from "agent
-    // was killed before it could write" (signal) or "agent crashed" (non-zero
-    // code). Without this distinction every clean-exit-no-handoff collapses
-    // into the same uninformative ambiguous-prompt body.
-    if (info.code !== undefined && info.code !== null) {
-        cause.exitCode = info.code;
-    }
-    if (info.signal)
-        cause.exitSignal = info.signal;
-    if (info.error)
-        cause.exitError = info.error.message;
-    return cause;
-}
-async function resolveFromHandoffOrPrompt(handoffFilePath, handoffsDir, userInterrupted = false, cause = {}) {
-    const read = (0, handoff_1.readHandoffWithReason)(handoffFilePath, handoffsDir);
-    if (read.ok === true) {
-        return {
-            kind: read.handoff.status,
-            summary: read.handoff.summary,
-            extras: read.handoff.extras,
-        };
-    }
-    const fullCause = {
-        ...cause,
-        handoff: { reason: read.reason, detail: read.detail },
-    };
-    if (userInterrupted) {
-        // User pressed Ctrl+C. Don't show the abort/continue prompt — they
-        // already told us what they want. Prompting in the TTY state left by a
-        // SIGINT-killed child also tripped enquirer's setRawMode-EIO and
-        // ERR_USE_AFTER_CLOSE bugs; whether @clack/prompts shares that fault is
-        // unverified, so the skip stays. The orchestrator's standard failure
-        // cascade surfaces the abort outcome.
-        //
-        // After user interruption, suppress conventional stop statuses and retain
-        // independent failure diagnostics for the caller to display.
-        const exitWasCtrlC = cause.exitCode === 130 ||
-            cause.exitCode === 143 ||
-            cause.exitSignal === 'SIGINT' ||
-            cause.exitSignal === 'SIGTERM';
-        const userScrubbed = {
-            exitError: cause.exitError,
-            exitCode: exitWasCtrlC ? undefined : cause.exitCode,
-            exitSignal: exitWasCtrlC ? undefined : cause.exitSignal,
-            handoff: read.reason === 'missing'
-                ? undefined
-                : { reason: read.reason, detail: read.detail },
-        };
-        const causeSummary = describeAmbiguousCause(userScrubbed);
-        return {
-            kind: 'ambiguous-abort',
-            ...(causeSummary.length > 0 && { causeSummary }),
-        };
-    }
-    return promptAmbiguous(fullCause);
-}
-async function promptAmbiguous(cause) {
-    // stderr blank line so the spacer lands in the same stream as output.warn
-    // and the prompt — buffered stdout could otherwise reorder it and glue the
-    // prompt to the agent's trailing exit message.
-    process.stderr.write('\n');
-    // Cause rendered ABOVE the prompt rather than inlined into its message:
-    // enquirer's select redraw used different math for clear (wrap-aware) vs
-    // restore (raw \n-split count), so a multi-line message could leave orphaned
-    // cells on arrow-key re-renders. Kept single-line because that constraint is
-    // unverified under @clack/prompts, not because the cause still applies.
-    const causeLines = describeAmbiguousCause(cause);
-    if (causeLines.length > 0) {
-        output_1.output.warn({
-            title: 'The agent run ended without a usable handoff',
-            bodyLines: causeLines,
-        });
-    }
-    // Cancelling exits 130 from inside the prompt; any other rejection is an
-    // abort.
-    try {
-        const choice = await (0, safe_prompt_1.migrateChoice)({
-            message: 'How should nx migrate proceed?',
-            choices: [
-                { value: 'abort', label: 'Treat as failed — abort the run' },
-                {
-                    value: 'continue',
-                    label: 'Treat as completed — mark done and continue',
-                },
-            ],
-        });
-        (0, migrate_analytics_1.reportMigratePrompt)('ambiguous_agent_outcome', choice);
-        return choice === 'continue'
-            ? { kind: 'ambiguous-continue' }
-            : { kind: 'ambiguous-abort' };
-    }
-    catch {
-        return { kind: 'ambiguous-abort' };
-    }
-}
-function describeAmbiguousCause(cause) {
-    const lines = [];
-    if (cause.spawnError) {
-        lines.push(`Could not spawn the agent: ${cause.spawnError}`);
-    }
-    if (cause.exitError) {
-        lines.push(`Agent process emitted an error: ${cause.exitError}`);
-    }
-    if (cause.exitCode !== undefined && cause.exitCode !== null) {
-        // Distinguish clean-exit-without-handoff (likely a deliberate close by
-        // the user, or the agent ended its session without invoking the handoff
-        // step) from a non-zero crash, so the prompt body doesn't collapse them
-        // into the same uninformative "exited with code N" line.
-        lines.push(cause.exitCode === 0
-            ? 'Agent exited cleanly (code 0) without writing a handoff.'
-            : `Agent exited with code ${cause.exitCode}.`);
-    }
-    if (cause.exitSignal) {
-        lines.push(`Agent was terminated by signal ${cause.exitSignal}.`);
-    }
-    // "No handoff file was written." is redundant when another cause line
-    // already implies it (spawn error, exit code/signal, process error).
-    // Independent diagnostics (read-error, parse-error, shape-mismatch) always
-    // surface — they're not implied by the exit shape.
-    const handoffMissingIsRedundant = !!cause.spawnError ||
-        !!cause.exitError ||
-        cause.exitCode !== undefined ||
-        cause.exitSignal !== undefined;
-    switch (cause.handoff?.reason) {
-        case 'missing':
-            if (!handoffMissingIsRedundant) {
-                lines.push('No handoff file was written.');
-            }
-            break;
-        case 'read-error':
-            lines.push(`Handoff file could not be read${cause.handoff.detail ? `: ${cause.handoff.detail}` : '.'}`);
-            break;
-        case 'parse-error':
-            lines.push(`Handoff file contained invalid JSON${cause.handoff.detail ? `: ${cause.handoff.detail}` : '.'}`);
-            break;
-        case 'shape-mismatch':
-            lines.push('Handoff file was missing required fields or had an unexpected shape.');
-            break;
-    }
-    return lines;
-}

package/dist/src/migrations/update-23-0-0/consolidate-release-tag-config.d.ts

@@ -1,9 +0,0 @@
-import type { Tree } from '../../generators/tree';
-/**
- * The deprecated releaseTag* flat properties were removed in Nx 23. Re-run the
- * v22 consolidation for any workspaces that still have the legacy keys (e.g.,
- * configs added manually after the v22 migration ran). Runs automatically as
- * part of `nx migrate` and is also triggered by `nx repair` when the runtime
- * detects legacy keys still present in `nx.json`.
- */
-export default function (tree: Tree): Promise<void>;

package/dist/src/migrations/update-23-0-0/consolidate-release-tag-config.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = default_1;
-const tslib_1 = require("tslib");
-const consolidate_release_tag_config_1 = tslib_1.__importDefault(require("../update-22-0-0/consolidate-release-tag-config"));
-/**
- * The deprecated releaseTag* flat properties were removed in Nx 23. Re-run the
- * v22 consolidation for any workspaces that still have the legacy keys (e.g.,
- * configs added manually after the v22 migration ran). Runs automatically as
- * part of `nx migrate` and is also triggered by `nx repair` when the runtime
- * detects legacy keys still present in `nx.json`.
- */
-// TODO(v24): remove this migration (along with its registration in
-// migrations.json) and the LEGACY_RELEASE_TAG_PATTERN_PROPERTIES_DETECTED
-// runtime error path in packages/nx/src/command-line/release/config/config.ts.
-async function default_1(tree) {
-    return (0, consolidate_release_tag_config_1.default)(tree);
-}

package/dist/src/tasks-runner/legacy-depends-on-warning.d.ts

@@ -1,18 +0,0 @@
-import { TargetDependencyConfig } from '../config/workspace-json-project-json';
-type LegacyValue = 'self' | 'dependencies';
-type LegacyEntry = TargetDependencyConfig & {
-    projects: LegacyValue;
-};
-export interface LegacyDependsOnViolation {
-    index: number;
-    originalEntry: LegacyEntry;
-}
-export interface LegacyDependsOnLocation {
-    ownerTarget?: string;
-    index?: number;
-    legacyViolations?: LegacyDependsOnViolation[];
-}
-export declare function warnLegacyDependsOnMagicString(currentProject: string | undefined, dependencyConfig: TargetDependencyConfig, location: LegacyDependsOnLocation | undefined): void;
-export declare function flushLegacyDependsOnViolations(project: string, ownerTarget: string, violations: LegacyDependsOnViolation[], projectRoot: string | undefined): void;
-export declare function __resetForTests(): void;
-export {};

package/dist/src/tasks-runner/legacy-depends-on-warning.js

@@ -1,109 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.warnLegacyDependsOnMagicString = warnLegacyDependsOnMagicString;
-exports.flushLegacyDependsOnViolations = flushLegacyDependsOnViolations;
-exports.__resetForTests = __resetForTests;
-const nx_deps_cache_1 = require("../project-graph/nx-deps-cache");
-const source_maps_1 = require("../project-graph/utils/project-configuration/source-maps");
-const output_1 = require("../utils/output");
-const warned = new Set();
-const isInternal = (p) => !p || p.startsWith('nx/');
-// Callers gate this on `dependencyConfig.projects` already being a legacy value;
-// the inner cast snapshots that runtime guarantee into the type system.
-function warnLegacyDependsOnMagicString(currentProject, dependencyConfig, location) {
-    const violation = {
-        index: location?.index ?? -1,
-        originalEntry: { ...dependencyConfig },
-    };
-    // Collector-aware caller (`getDependencyConfigs`) batches violations so the
-    // warning can group all offending entries for a single target. External
-    // callers fall through to an immediate per-entry warning.
-    if (location?.legacyViolations)
-        return void location.legacyViolations.push(violation);
-    flushLegacyDependsOnViolations(currentProject ?? '<unknown>', location?.ownerTarget ?? '<unknown>', [violation], undefined);
-}
-function flushLegacyDependsOnViolations(project, ownerTarget, violations, projectRoot) {
-    if (violations.length === 0)
-        return;
-    // Read source maps fresh each flush so daemon-cached maps don't go stale;
-    // only runs when violations exist, which is rare.
-    let sourceMaps = null;
-    try {
-        sourceMaps = (0, nx_deps_cache_1.readSourceMapsCache)();
-    }
-    catch { } // best-effort context
-    const map = projectRoot && sourceMaps ? sourceMaps[projectRoot] : undefined;
-    const arrayKey = `targets.${ownerTarget}.dependsOn`;
-    const items = violations.map((v) => {
-        const info = map
-            ? (0, source_maps_1.readArrayItemSourceInfo)(map, arrayKey, v.index)
-            : undefined;
-        return {
-            ...v,
-            value: v.originalEntry.projects,
-            plugin: info?.[1],
-            file: info?.[0] ?? undefined,
-        };
-    });
-    const shared = (key) => items.every((i) => i[key] === items[0][key]) ? items[0][key] : null;
-    const value = shared('value');
-    const plugin = shared('plugin');
-    const file = shared('file');
-    // External-plugin warnings are workspace-wide (the plugin's behavior, not a
-    // specific config): dedupe per (plugin, value) so the user sees one warning
-    // per offending plugin, not one per affected target.
-    const dedupeKey = plugin && !isInternal(plugin) && value
-        ? `plugin::${plugin}::${value}`
-        : `target::${project}::${ownerTarget}`;
-    if (warned.has(dedupeKey))
-        return;
-    warned.add(dedupeKey);
-    const n = items.length;
-    const word = n === 1 ? 'entry' : 'entries';
-    const deprecation = 'This is deprecated and will be removed in Nx v24 —';
-    let phrase;
-    if (value) {
-        phrase = `projects: '${value}'`;
-    }
-    else {
-        const self = items.filter((i) => i.value === 'self').length;
-        phrase = `legacy projects values (${self} 'self', ${n - self} 'dependencies')`;
-    }
-    let title;
-    let suppressBody = false;
-    if (plugin && !isInternal(plugin)) {
-        // Single external plugin: same plugin emits the same value across projects.
-        title = `The ${plugin} plugin infers dependsOn entries using ${phrase}. ${deprecation} please upgrade ${plugin} to a version that doesn't emit this.`;
-        suppressBody = true;
-    }
-    else if (plugin && isInternal(plugin) && file) {
-        // Single hand-authored config file — lead with the file path.
-        title = `${file} defines ${project}:${ownerTarget} with ${n} dependsOn ${word} using ${phrase}. ${deprecation} run 'nx repair' to fix this.`;
-    }
-    else {
-        // Mixed sources or no source-map info — tailor advice to what's offending.
-        const offending = Array.from(new Set(items
-            .filter((i) => i.plugin && !isInternal(i.plugin))
-            .map((i) => i.plugin)));
-        const origin = plugin
-            ? ` (set by ${plugin}${file ? ` in ${file}` : ''})`
-            : '';
-        const advice = offending.length
-            ? `run 'nx repair' for hand-authored entries and upgrade ${offending.join(', ')} for plugin-inferred entries`
-            : `run 'nx repair' to fix`;
-        title = `${project}:${ownerTarget} has ${n} dependsOn ${word} using ${phrase}${origin}. ${deprecation} ${advice}.`;
-    }
-    const bodyLines = suppressBody
-        ? []
-        : items.map((i) => {
-            const src = i.plugin && !plugin
-                ? ` from ${i.plugin}${i.file ? ` in ${i.file}` : ''}`
-                : '';
-            return `  - ${JSON.stringify(i.originalEntry)} (${i.index}${src})`;
-        });
-    output_1.output.warn({ title, bodyLines });
-}
-// Test-only: clears the process-wide dedupe set.
-function __resetForTests() {
-    warned.clear();
-}