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

package/dist/src/command-line/init/utils/ai-output.d.ts

@@ -1,72 +0,0 @@
-/**
- * AI Agent NDJSON Output Utilities for nx init
- *
- * Extends the shared base with init-specific types and builders.
- *
- * NOTE: This is intentionally duplicated from create-nx-workspace.
- * CNW is self-contained and cannot import from the nx package.
- */
-import { writeAiOutput, logProgress, writeErrorLog, type ProgressMessage, type DetectedPlugin, type NextStep, type UserNextSteps, type PluginWarning, type BaseProgressStage } from '../../ai/ai-output';
-export { writeAiOutput, logProgress, writeErrorLog };
-export type { ProgressMessage, DetectedPlugin, NextStep, UserNextSteps, PluginWarning, BaseProgressStage, };
-export type ProgressStage = 'starting' | 'detecting' | 'configuring' | 'installing' | 'plugins' | 'complete' | 'error' | 'needs_input';
-export type NxInitErrorCode = 'ALREADY_INITIALIZED' | 'PACKAGE_INSTALL_ERROR' | 'UNCOMMITTED_CHANGES' | 'UNSUPPORTED_PROJECT' | 'PLUGIN_INIT_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN';
-export interface NeedsInputResult {
-    stage: 'needs_input';
-    success: false;
-    inputType: 'plugins';
-    message: string;
-    detectedPlugins: DetectedPlugin[];
-    options: string[];
-    recommendedOption: string;
-    recommendedReason: string;
-    exampleCommand: string;
-}
-export interface SuccessResult {
-    stage: 'complete';
-    success: true;
-    result: {
-        nxVersion: string;
-        pluginsInstalled: string[];
-    };
-    warnings?: PluginWarning[];
-    userNextSteps: UserNextSteps;
-    docs: {
-        gettingStarted: string;
-        nxCloud: string;
-    };
-}
-export interface ErrorResult {
-    stage: 'error';
-    success: false;
-    errorCode: NxInitErrorCode;
-    error: string;
-    hints: string[];
-    errorLogPath?: string;
-}
-export type AiOutputMessage = ProgressMessage | NeedsInputResult | SuccessResult | ErrorResult;
-/**
- * Build needs_input result for plugin selection.
- * This tells the AI which plugins are available and how to proceed.
- */
-export declare function buildNeedsInputResult(detectedPlugins: DetectedPlugin[]): NeedsInputResult;
-/**
- * Build success result object with next steps.
- */
-export declare function buildSuccessResult(options: {
-    nxVersion: string;
-    pluginsInstalled: string[];
-    warnings?: PluginWarning[];
-}): SuccessResult;
-/**
- * Build error result object with helpful hints.
- */
-export declare function buildErrorResult(error: string, errorCode: NxInitErrorCode, errorLogPath?: string): ErrorResult;
-/**
- * Get helpful hints based on error code.
- */
-export declare function getErrorHints(errorCode: NxInitErrorCode): string[];
-/**
- * Determine error code from an error object.
- */
-export declare function determineErrorCode(error: Error | unknown): NxInitErrorCode;

package/dist/src/command-line/init/utils/ai-output.js

@@ -1,180 +0,0 @@
-"use strict";
-/**
- * AI Agent NDJSON Output Utilities for nx init
- *
- * Extends the shared base with init-specific types and builders.
- *
- * NOTE: This is intentionally duplicated from create-nx-workspace.
- * CNW is self-contained and cannot import from the nx package.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeErrorLog = exports.logProgress = exports.writeAiOutput = void 0;
-exports.buildNeedsInputResult = buildNeedsInputResult;
-exports.buildSuccessResult = buildSuccessResult;
-exports.buildErrorResult = buildErrorResult;
-exports.getErrorHints = getErrorHints;
-exports.determineErrorCode = determineErrorCode;
-// Import shared base types and utilities
-const ai_output_1 = require("../../ai/ai-output");
-Object.defineProperty(exports, "writeAiOutput", { enumerable: true, get: function () { return ai_output_1.writeAiOutput; } });
-Object.defineProperty(exports, "logProgress", { enumerable: true, get: function () { return ai_output_1.logProgress; } });
-Object.defineProperty(exports, "writeErrorLog", { enumerable: true, get: function () { return ai_output_1.writeErrorLog; } });
-/**
- * Build needs_input result for plugin selection.
- * This tells the AI which plugins are available and how to proceed.
- */
-function buildNeedsInputResult(detectedPlugins) {
-    const pluginList = detectedPlugins.map((p) => p.name).join(',');
-    return {
-        stage: 'needs_input',
-        success: false,
-        inputType: 'plugins',
-        message: 'Plugin selection required. Ask the user which plugins to install, then run again with --plugins flag.',
-        detectedPlugins,
-        options: ['--plugins=skip', '--plugins=all', `--plugins=${pluginList}`],
-        recommendedOption: '--plugins=skip',
-        recommendedReason: 'Plugins can be added later with nx add.',
-        exampleCommand: `nx init --plugins=${detectedPlugins[0]?.name || '@nx/vite'}`,
-    };
-}
-/**
- * Build success result object with next steps.
- */
-function buildSuccessResult(options) {
-    const { nxVersion, pluginsInstalled, warnings } = options;
-    // Build user-facing next steps
-    const steps = [
-        {
-            title: 'Explore your workspace',
-            command: 'nx graph',
-            note: 'Visualize project dependencies',
-        },
-        {
-            title: 'List projects and details',
-            command: 'nx show projects',
-            note: 'Or nx show project <project-name> to see targets and configuration',
-        },
-        {
-            title: 'Run a task',
-            command: 'nx run <project>:<script>',
-            note: 'Run any script from a project package.json (e.g., nx run client:build)',
-        },
-        {
-            title: 'Enable Remote Caching',
-            command: 'nx connect',
-            note: 'Speed up CI by 30-70% with Nx Cloud',
-        },
-    ];
-    const successResult = {
-        stage: 'complete',
-        success: true,
-        result: {
-            nxVersion,
-            pluginsInstalled,
-        },
-        userNextSteps: {
-            description: 'Show user these steps to complete setup.',
-            steps,
-        },
-        docs: {
-            gettingStarted: 'https://nx.dev/getting-started/intro',
-            nxCloud: 'https://nx.dev/ci/intro/why-nx-cloud',
-        },
-    };
-    if (warnings && warnings.length > 0) {
-        successResult.warnings = warnings;
-    }
-    return successResult;
-}
-/**
- * Build error result object with helpful hints.
- */
-function buildErrorResult(error, errorCode, errorLogPath) {
-    const hints = getErrorHints(errorCode);
-    return {
-        stage: 'error',
-        success: false,
-        errorCode,
-        error,
-        hints,
-        errorLogPath,
-    };
-}
-/**
- * Get helpful hints based on error code.
- */
-function getErrorHints(errorCode) {
-    switch (errorCode) {
-        case 'ALREADY_INITIALIZED':
-            return [
-                'Workspace already has nx.json',
-                'Remove nx.json to reinitialize',
-                'Use nx add to add plugins to existing workspace',
-            ];
-        case 'PACKAGE_INSTALL_ERROR':
-            return [
-                'Check your package manager is installed correctly',
-                'Try clearing npm/yarn/pnpm cache',
-                'Check for conflicting global packages',
-            ];
-        case 'UNCOMMITTED_CHANGES':
-            return [
-                'Commit or stash your changes before running nx init',
-                'Use --force to skip this check (not recommended)',
-            ];
-        case 'UNSUPPORTED_PROJECT':
-            return [
-                'Project type could not be detected',
-                'Ensure you are in a valid project directory',
-                'Check https://nx.dev/getting-started for supported project types',
-            ];
-        case 'PLUGIN_INIT_ERROR':
-            return [
-                'One or more plugin init generators failed',
-                'Check the error log for details',
-                "Try running 'nx add <plugin>' manually",
-            ];
-        case 'NETWORK_ERROR':
-            return [
-                'Check your internet connection',
-                'Try again in a few moments',
-                'Check if npm registry is accessible',
-            ];
-        default:
-            return [
-                'An unexpected error occurred',
-                'Check the error log for details',
-                'Report issues at https://github.com/nrwl/nx/issues',
-            ];
-    }
-}
-/**
- * Determine error code from an error object.
- */
-function determineErrorCode(error) {
-    const message = error instanceof Error ? error.message : String(error);
-    const lowerMessage = message.toLowerCase();
-    if (lowerMessage.includes('nx.json already exists') ||
-        lowerMessage.includes('already initialized')) {
-        return 'ALREADY_INITIALIZED';
-    }
-    if (lowerMessage.includes('install') ||
-        lowerMessage.includes('npm') ||
-        lowerMessage.includes('yarn') ||
-        lowerMessage.includes('pnpm')) {
-        return 'PACKAGE_INSTALL_ERROR';
-    }
-    if (lowerMessage.includes('uncommitted') ||
-        lowerMessage.includes('git status')) {
-        return 'UNCOMMITTED_CHANGES';
-    }
-    if (lowerMessage.includes('network') ||
-        lowerMessage.includes('enotfound') ||
-        lowerMessage.includes('etimedout')) {
-        return 'NETWORK_ERROR';
-    }
-    if (lowerMessage.includes('plugin') || lowerMessage.includes('generator')) {
-        return 'PLUGIN_INIT_ERROR';
-    }
-    return 'UNKNOWN';
-}

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

@@ -1,2 +0,0 @@
-import { CommandModule } from 'yargs';
-export declare const yargsListCommand: CommandModule;

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

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.yargsListCommand = void 0;
-const handle_import_1 = require("../../utils/handle-import");
-exports.yargsListCommand = {
-    command: 'list [plugin]',
-    describe: 'Lists installed plugins, capabilities of installed plugins and other available plugins.',
-    builder: (yargs) => yargs
-        .positional('plugin', {
-        type: 'string',
-        description: 'The name of an installed plugin to query.',
-    })
-        .option('json', {
-        type: 'boolean',
-        description: 'Output JSON.',
-    }),
-    handler: async (args) => {
-        await (await (0, handle_import_1.handleImport)('./list.js', __dirname)).listHandler(args);
-        process.exit(0);
-    },
-};

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

@@ -1,15 +0,0 @@
-export interface ListArgs {
-    /** The name of an installed plugin to query  */
-    plugin?: string | undefined;
-    /** Output as JSON */
-    json?: boolean;
-}
-/**
- * List available plugins or capabilities within a specific plugin
- *
- * @remarks
- *
- * Must be run within an Nx workspace
- *
- */
-export declare function listHandler(args: ListArgs): Promise<void>;

package/dist/src/command-line/list/list.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.listHandler = listHandler;
-const nx_json_1 = require("../../config/nx-json");
-const project_graph_1 = require("../../project-graph/project-graph");
-const output_1 = require("../../utils/output");
-const plugins_1 = require("../../utils/plugins");
-const workspace_root_1 = require("../../utils/workspace-root");
-const output_2 = require("../../utils/plugins/output");
-/**
- * List available plugins or capabilities within a specific plugin
- *
- * @remarks
- *
- * Must be run within an Nx workspace
- *
- */
-async function listHandler(args) {
-    const projectGraph = await (0, project_graph_1.createProjectGraphAsync)({ exitOnError: true });
-    const projects = (0, project_graph_1.readProjectsConfigurationFromProjectGraph)(projectGraph);
-    if (args.plugin) {
-        await (0, plugins_1.listPluginCapabilities)(args.plugin, projects.projects, args.json);
-    }
-    else {
-        const nxJson = (0, nx_json_1.readNxJson)();
-        const localPlugins = await (0, plugins_1.getLocalWorkspacePlugins)(projects, nxJson);
-        const installedPlugins = await (0, plugins_1.getInstalledPluginsAndCapabilities)(workspace_root_1.workspaceRoot, projects.projects);
-        if (args.json) {
-            console.log(JSON.stringify((0, output_2.formatPluginsAsJson)(localPlugins, installedPlugins), null, 2));
-            return;
-        }
-        if (localPlugins.size) {
-            (0, plugins_1.listPlugins)(localPlugins, 'Local workspace plugins:');
-        }
-        (0, plugins_1.listPlugins)(installedPlugins, 'Installed plugins:');
-        (0, plugins_1.listAlsoAvailableCorePlugins)(installedPlugins);
-        (0, output_2.listPowerpackPlugins)();
-        output_1.output.note({
-            title: 'Community Plugins',
-            bodyLines: [
-                'Looking for a technology / framework not listed above?',
-                'There are many excellent plugins maintained by the Nx community.',
-                'Search for the one you need here: https://nx.dev/plugin-registry.',
-            ],
-        });
-        output_1.output.note({ title: `Use "nx list [plugin]" to find out more` });
-    }
-}

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

@@ -1,2 +0,0 @@
-import { CommandModule } from 'yargs';
-export declare const yargsMcpCommand: CommandModule;

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

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.yargsMcpCommand = void 0;
-const handle_import_1 = require("../../utils/handle-import");
-exports.yargsMcpCommand = {
-    command: 'mcp',
-    describe: 'Starts the Nx MCP server.',
-    // @ts-expect-error - yargs types are outdated, refer to docs - https://github.com/yargs/yargs/blob/main/docs/api.md#commandmodule
-    builder: async (y, helpOrVersionSet) => {
-        if (helpOrVersionSet) {
-            (await (0, handle_import_1.handleImport)('./mcp', __dirname)).showHelp();
-            process.exit(0);
-        }
-        return y
-            .version(false)
-            .strict(false)
-            .parserConfiguration({
-            'unknown-options-as-args': true,
-            'populate--': true,
-        })
-            .usage('')
-            .help(false)
-            .showHelpOnFail(false);
-    },
-    handler: async (args) => {
-        await (await (0, handle_import_1.handleImport)('./mcp.js', __dirname)).mcpHandler(args);
-        process.exit(0);
-    },
-};

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

@@ -1,2 +0,0 @@
-export declare function mcpHandler(args: any): Promise<void>;
-export declare function showHelp(): Promise<void>;

package/dist/src/command-line/mcp/mcp.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mcpHandler = mcpHandler;
-exports.showHelp = showHelp;
-const child_process_1 = require("child_process");
-const package_manager_1 = require("../../utils/package-manager");
-const workspace_root_1 = require("../../utils/workspace-root");
-async function mcpHandler(args) {
-    const packageManager = (0, package_manager_1.detectPackageManager)();
-    const packageManagerCommands = (0, package_manager_1.getPackageManagerCommand)(packageManager);
-    const passthroughArgs = args['_'][0] === 'mcp' ? args['_'].slice(1) : args['_'];
-    let dlxArgs;
-    if (packageManager === 'npm') {
-        dlxArgs = ['-y', 'nx-mcp@latest', ...passthroughArgs];
-    }
-    else if (packageManager === 'yarn') {
-        dlxArgs = ['--quiet', 'nx-mcp@latest', ...passthroughArgs];
-    }
-    else if (packageManager === 'bun') {
-        dlxArgs = ['--silent', 'nx-mcp@latest', ...passthroughArgs];
-    }
-    else {
-        dlxArgs = ['nx-mcp@latest', ...passthroughArgs];
-    }
-    // For commands that might contain spaces like "pnpm dlx"
-    const dlxCommand = packageManagerCommands.dlx.split(' ');
-    const executable = dlxCommand[0];
-    const execArgs = [...dlxCommand.slice(1), ...dlxArgs];
-    (0, child_process_1.spawnSync)(executable, execArgs, {
-        stdio: 'inherit',
-        cwd: workspace_root_1.workspaceRoot,
-        windowsHide: true,
-    });
-}
-async function showHelp() {
-    const packageManager = (0, package_manager_1.detectPackageManager)();
-    const packageManagerCommands = (0, package_manager_1.getPackageManagerCommand)(packageManager);
-    let dlxArgs;
-    if (packageManager === 'npm') {
-        dlxArgs = ['-y', 'nx-mcp@latest', '--help'];
-    }
-    else if (packageManager === 'yarn') {
-        dlxArgs = ['--quiet', 'nx-mcp@latest', '--help'];
-    }
-    else if (packageManager === 'bun') {
-        dlxArgs = ['--silent', 'nx-mcp@latest', '--help'];
-    }
-    else {
-        dlxArgs = ['nx-mcp@latest', '--help'];
-    }
-    const dlxCommand = packageManagerCommands.dlx.split(' ');
-    const executable = dlxCommand[0];
-    const execArgs = [...dlxCommand.slice(1), ...dlxArgs];
-    const helpOutput = (0, child_process_1.spawnSync)(executable, execArgs, {
-        cwd: workspace_root_1.workspaceRoot,
-        encoding: 'utf-8',
-        windowsHide: true,
-    });
-    console.log(helpOutput.stdout?.toString().replaceAll('nx-mcp', 'nx mcp'));
-}

package/dist/src/command-line/migrate/agentic/capture-generator-output.d.ts

@@ -1,22 +0,0 @@
-/**
- * Tees `console.{log,warn,error,info,debug}` into an internal buffer while
- * preserving the original behavior. Does not intercept
- * `process.{stdout,stderr}.write` — those bypass `console` and would also
- * pick up unrelated framework output. Restoration is idempotent.
- */
-export interface GeneratorOutputCapture {
-    flush(): string;
-    restore(): void;
-}
-export declare function installGeneratorOutputCapture(): GeneratorOutputCapture;
-/**
- * Convenience wrapper that installs the capture, runs `fn`, restores on
- * completion or throw, and returns the captured logs alongside `fn`'s value.
- * Throws from `fn` propagate with the captured logs attached as
- * `(err as any).capturedLogs` — the most useful diagnostic when a generator
- * crashes mid-output.
- */
-export declare function withGeneratorOutputCapture<T>(fn: () => Promise<T> | T): Promise<{
-    result: T;
-    logs: string;
-}>;

package/dist/src/command-line/migrate/agentic/capture-generator-output.js

@@ -1,100 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.installGeneratorOutputCapture = installGeneratorOutputCapture;
-exports.withGeneratorOutputCapture = withGeneratorOutputCapture;
-const node_util_1 = require("node:util");
-const logger_1 = require("../../../utils/logger");
-const CONSOLE_METHODS = [
-    'log',
-    'warn',
-    'error',
-    'info',
-    'debug',
-];
-// Marks `console[method]` as a wrapper installed by this module. Seeing it on
-// entry means the previous install never restored — refuse rather than layer,
-// otherwise the leak compounds silently into a wrapper-wrapping-a-wrapper.
-const CAPTURED_MARKER = Symbol.for('nx-migrate.generator-output-captured');
-const NOOP_CAPTURE = {
-    flush: () => '',
-    restore: () => { },
-};
-function installGeneratorOutputCapture() {
-    // Refuse to layer if the previous install never restored. Returns a noop
-    // handle so callers' `flush()` / `restore()` calls remain safe.
-    for (const method of CONSOLE_METHODS) {
-        if (console[method][CAPTURED_MARKER]) {
-            logger_1.logger.verbose(`nx migrate: refusing to layer a second generator-output capture; the previous one was not restored. This typically means a caller skipped its \`try/finally\`. The inner caller's \`flush()\` will return empty, but its console output is still being captured by the outer install.`);
-            return NOOP_CAPTURE;
-        }
-    }
-    const buffer = [];
-    const originals = new Map();
-    for (const method of CONSOLE_METHODS) {
-        originals.set(method, console[method]);
-        const original = console[method].bind(console);
-        const wrapper = ((...args) => {
-            original(...args);
-            try {
-                buffer.push((0, node_util_1.format)(...args));
-            }
-            catch {
-                // `format` is robust against the common pathologies but a user arg
-                // with a throwing `toString()` would otherwise turn a benign
-                // `console.log(...)` into a generator crash.
-            }
-        });
-        Object.defineProperty(wrapper, CAPTURED_MARKER, {
-            value: true,
-            enumerable: false,
-            configurable: true,
-            writable: false,
-        });
-        console[method] = wrapper;
-    }
-    let restored = false;
-    return {
-        flush() {
-            return buffer.join('\n');
-        },
-        restore() {
-            if (restored)
-                return;
-            restored = true;
-            for (const [method, fn] of originals) {
-                console[method] = fn;
-            }
-        },
-    };
-}
-/**
- * Convenience wrapper that installs the capture, runs `fn`, restores on
- * completion or throw, and returns the captured logs alongside `fn`'s value.
- * Throws from `fn` propagate with the captured logs attached as
- * `(err as any).capturedLogs` — the most useful diagnostic when a generator
- * crashes mid-output.
- */
-async function withGeneratorOutputCapture(fn) {
-    const capture = installGeneratorOutputCapture();
-    try {
-        const result = await fn();
-        return { result, logs: capture.flush() };
-    }
-    catch (err) {
-        if (err && typeof err === 'object') {
-            // A frozen / sealed / non-extensible error would make this throw a
-            // TypeError under TS-emitted strict-mode code, masking the original
-            // generator error. Swallow that failure; the diagnostic is best-effort.
-            try {
-                err.capturedLogs = capture.flush();
-            }
-            catch {
-                /* attachment failed; preserve the original error */
-            }
-        }
-        throw err;
-    }
-    finally {
-        capture.restore();
-    }
-}

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

@@ -1,12 +0,0 @@
-/**
- * Canonical list of agent ids for the migrate agentic flow. Used by the yargs
- * layer for `--agentic` validation and by the runtime as the source of truth
- * for the {@link AgentId} union.
- */
-export declare const AGENT_IDS: readonly ['claude-code', 'codex', 'opencode'];
-export type AgentId = (typeof AGENT_IDS)[number];
-/**
- * Shape-only normalization of `--agentic`; validation of agent-id strings is
- * done upstream in the yargs `.check()` chain.
- */
-export declare function coerceAgenticArg(value: unknown): string | boolean | undefined;

package/dist/src/command-line/migrate/agentic/cli-args.js

@@ -1,38 +0,0 @@
-"use strict";
-// Zero-dep helpers for --agentic — keeps the agentic chain out of every
-// nx CLI startup.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENT_IDS = void 0;
-exports.coerceAgenticArg = coerceAgenticArg;
-/**
- * Canonical list of agent ids for the migrate agentic flow. Used by the yargs
- * layer for `--agentic` validation and by the runtime as the source of truth
- * for the {@link AgentId} union.
- */
-exports.AGENT_IDS = ['claude-code', 'codex', 'opencode'];
-/**
- * Shape-only normalization of `--agentic`; validation of agent-id strings is
- * done upstream in the yargs `.check()` chain.
- */
-function coerceAgenticArg(value) {
-    if (value === undefined)
-        return undefined;
-    // yargs collects repeated occurrences into an array; error rather than
-    // silently picking last/first. `--agentic` is single-value by intent.
-    if (Array.isArray(value)) {
-        const received = value
-            .map((v) => (typeof v === 'string' ? `--agentic=${v}` : '--agentic'))
-            .join(' ');
-        throw new Error(`Error: --agentic was passed more than once (received: ${received}). Specify --agentic at most one time.`);
-    }
-    if (value === true || value === '' || value === 'true' || value === 'yes') {
-        return true;
-    }
-    if (value === false || value === 'false' || value === 'no') {
-        return false;
-    }
-    if (typeof value === 'string') {
-        return value;
-    }
-    return undefined;
-}

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

@@ -1,6 +0,0 @@
-import { AgentDefinition, AgentId } from './types';
-export declare const claudeCodeDefinition: AgentDefinition;
-export declare const codexDefinition: AgentDefinition;
-export declare const opencodeDefinition: AgentDefinition;
-export declare const AGENT_DEFINITIONS: readonly AgentDefinition[];
-export declare function getAgentDefinition(id: AgentId): AgentDefinition | undefined;