@depup/angular__cli 21.2.1-depup.1

package/src/commands/mcp/tools/tool-registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import type { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types';
+import type { ZodRawShape } from 'zod';
+import type { AngularWorkspace } from '../../../utilities/config';
+import type { Devserver } from '../devserver';
+import type { Host } from '../host';
+export interface McpToolContext {
+    server: McpServer;
+    workspace?: AngularWorkspace;
+    logger: {
+        warn(text: string): void;
+    };
+    exampleDatabasePath?: string;
+    devservers: Map<string, Devserver>;
+    host: Host;
+}
+export type McpToolFactory<TInput extends ZodRawShape> = (context: McpToolContext) => ToolCallback<TInput> | Promise<ToolCallback<TInput>>;
+export interface McpToolDeclaration<TInput extends ZodRawShape, TOutput extends ZodRawShape> {
+    name: string;
+    title?: string;
+    description: string;
+    annotations?: ToolAnnotations;
+    inputSchema?: TInput;
+    outputSchema?: TOutput;
+    factory: McpToolFactory<TInput>;
+    shouldRegister?: (context: McpToolContext) => boolean | Promise<boolean>;
+    isReadOnly?: boolean;
+    isLocalOnly?: boolean;
+}
+export type AnyMcpToolDeclaration = McpToolDeclaration<any, any>;
+export declare function declareTool<TInput extends ZodRawShape, TOutput extends ZodRawShape>(declaration: McpToolDeclaration<TInput, TOutput>): McpToolDeclaration<TInput, TOutput>;
+export declare function registerTools(server: McpServer, context: Omit<McpToolContext, 'server'>, declarations: AnyMcpToolDeclaration[]): Promise<void>;

package/src/commands/mcp/tools/tool-registry.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.declareTool = declareTool;
+exports.registerTools = registerTools;
+function declareTool(declaration) {
+    return declaration;
+}
+async function registerTools(server, context, declarations) {
+    for (const declaration of declarations) {
+        const toolContext = { ...context, server };
+        if (declaration.shouldRegister && !(await declaration.shouldRegister(toolContext))) {
+            continue;
+        }
+        const { name, factory, shouldRegister, isReadOnly, isLocalOnly, ...config } = declaration;
+        const handler = await factory(toolContext);
+        // Add declarative characteristics to annotations
+        config.annotations ??= {};
+        if (isReadOnly !== undefined) {
+            config.annotations.readOnlyHint = isReadOnly;
+        }
+        if (isLocalOnly !== undefined) {
+            // openWorldHint: false means local only
+            config.annotations.openWorldHint = !isLocalOnly;
+        }
+        server.registerTool(name, config, handler);
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/src/commands/mcp/tools/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["tool-registry.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAwCH,kCAIC;AAED,sCA2BC;AAjCD,SAAgB,WAAW,CACzB,WAAgD;IAEhD,OAAO,WAAW,CAAC;AACrB,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,MAAiB,EACjB,OAAuC,EACvC,YAAqC;IAErC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;QAC3C,IAAI,WAAW,CAAC,cAAc,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YACnF,SAAS;QACX,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,GAAG,WAAW,CAAC;QAE1F,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;QAE3C,iDAAiD;QACjD,MAAM,CAAC,WAAW,KAAK,EAAE,CAAC;QAC1B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,WAAW,CAAC,YAAY,GAAG,UAAU,CAAC;QAC/C,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,wCAAwC;YACxC,MAAM,CAAC,WAAW,CAAC,aAAa,GAAG,CAAC,WAAW,CAAC;QAClD,CAAC;QAED,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/src/commands/mcp/utils.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+/**
+ * Returns simple structured content output from an MCP tool.
+ *
+ * @returns A structure with both `content` and `structuredContent` for maximum compatibility.
+ */
+export declare function createStructuredContentOutput<OutputType>(structuredContent: OutputType): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: OutputType;
+};
+/**
+ * Get the logs of a failing command.
+ *
+ * This call has fallbacks in case the exception was thrown from the command-calling code itself.
+ */
+export declare function getCommandErrorLogs(e: unknown): string[];

package/src/commands/mcp/utils.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStructuredContentOutput = createStructuredContentOutput;
+exports.getCommandErrorLogs = getCommandErrorLogs;
+/**
+ * @fileoverview
+ * Utility functions shared across MCP tools.
+ */
+const host_1 = require("./host");
+/**
+ * Returns simple structured content output from an MCP tool.
+ *
+ * @returns A structure with both `content` and `structuredContent` for maximum compatibility.
+ */
+function createStructuredContentOutput(structuredContent) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(structuredContent, null, 2) }],
+        structuredContent,
+    };
+}
+/**
+ * Get the logs of a failing command.
+ *
+ * This call has fallbacks in case the exception was thrown from the command-calling code itself.
+ */
+function getCommandErrorLogs(e) {
+    if (e instanceof host_1.CommandError) {
+        return [...e.logs, e.message];
+    }
+    else if (e instanceof Error) {
+        return [e.message];
+    }
+    else {
+        return [String(e)];
+    }
+}
+//# sourceMappingURL=utils.js.map

package/src/commands/mcp/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["utils.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAcH,sEAKC;AAOD,kDAQC;AAhCD;;;GAGG;AAEH,iCAAsC;AAEtC;;;;GAIG;AACH,SAAgB,6BAA6B,CAAa,iBAA6B;IACrF,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACtF,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,CAAU;IAC5C,IAAI,CAAC,YAAY,mBAAY,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/src/commands/mcp/workspace-utils.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { workspaces } from '@angular-devkit/core';
+import { AngularWorkspace } from '../../utilities/config';
+import { type Host } from './host';
+import { McpToolContext } from './tools/tool-registry';
+/**
+ * Searches for an angular.json file by traversing up the directory tree from a starting directory.
+ *
+ * @param startDir The directory path to start searching from
+ * @param host The workspace host instance used to check file existence. Defaults to LocalWorkspaceHost
+ * @returns The absolute path to the directory containing angular.json, or null if not found
+ *
+ * @remarks
+ * This function performs an upward directory traversal starting from `startDir`.
+ * It checks each directory for the presence of an angular.json file until either:
+ * - The file is found (returns the directory path)
+ * - The root of the filesystem is reached (returns null)
+ */
+export declare function findAngularJsonDir(startDir: string, host?: Host): string | null;
+/**
+ * Searches for a project in the current workspace, by name.
+ */
+export declare function getProject(context: McpToolContext, name: string): workspaces.ProjectDefinition | undefined;
+/**
+ * Returns the name of the default project in the current workspace, or undefined if none exists.
+ *
+ * If no default project is defined but there's only a single project in the workspace, its name will
+ * be returned.
+ */
+export declare function getDefaultProjectName(workspace: AngularWorkspace | undefined): string | undefined;
+/**
+ * Resolves workspace and project for tools to operate on.
+ *
+ * If `workspacePathInput` is absent, uses the MCP's configured workspace. If none is configured, use the
+ * current directory as the workspace.
+ * If `projectNameInput` is absent, uses the default project in the workspace.
+ */
+export declare function resolveWorkspaceAndProject({ host, workspacePathInput, projectNameInput, mcpWorkspace, }: {
+    host: Host;
+    workspacePathInput?: string;
+    projectNameInput?: string;
+    mcpWorkspace?: AngularWorkspace;
+}): Promise<{
+    workspace: AngularWorkspace;
+    workspacePath: string;
+    projectName: string;
+}>;

package/src/commands/mcp/workspace-utils.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findAngularJsonDir = findAngularJsonDir;
+exports.getProject = getProject;
+exports.getDefaultProjectName = getDefaultProjectName;
+exports.resolveWorkspaceAndProject = resolveWorkspaceAndProject;
+const node_path_1 = require("node:path");
+const config_1 = require("../../utilities/config");
+const host_1 = require("./host");
+/**
+ * Searches for an angular.json file by traversing up the directory tree from a starting directory.
+ *
+ * @param startDir The directory path to start searching from
+ * @param host The workspace host instance used to check file existence. Defaults to LocalWorkspaceHost
+ * @returns The absolute path to the directory containing angular.json, or null if not found
+ *
+ * @remarks
+ * This function performs an upward directory traversal starting from `startDir`.
+ * It checks each directory for the presence of an angular.json file until either:
+ * - The file is found (returns the directory path)
+ * - The root of the filesystem is reached (returns null)
+ */
+function findAngularJsonDir(startDir, host = host_1.LocalWorkspaceHost) {
+    let currentDir = startDir;
+    while (true) {
+        if (host.existsSync((0, node_path_1.join)(currentDir, 'angular.json'))) {
+            return currentDir;
+        }
+        const parentDir = (0, node_path_1.dirname)(currentDir);
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+/**
+ * Searches for a project in the current workspace, by name.
+ */
+function getProject(context, name) {
+    const projects = context.workspace?.projects;
+    if (!projects) {
+        return undefined;
+    }
+    return projects.get(name);
+}
+/**
+ * Returns the name of the default project in the current workspace, or undefined if none exists.
+ *
+ * If no default project is defined but there's only a single project in the workspace, its name will
+ * be returned.
+ */
+function getDefaultProjectName(workspace) {
+    const projects = workspace?.projects;
+    if (!projects) {
+        return undefined;
+    }
+    const defaultProjectName = workspace?.extensions['defaultProject'];
+    if (defaultProjectName) {
+        return defaultProjectName;
+    }
+    // No default project defined? This might still be salvageable if only a single project exists.
+    if (projects.size === 1) {
+        return Array.from(projects.keys())[0];
+    }
+    return undefined;
+}
+/**
+ * Resolves workspace and project for tools to operate on.
+ *
+ * If `workspacePathInput` is absent, uses the MCP's configured workspace. If none is configured, use the
+ * current directory as the workspace.
+ * If `projectNameInput` is absent, uses the default project in the workspace.
+ */
+async function resolveWorkspaceAndProject({ host, workspacePathInput, projectNameInput, mcpWorkspace, }) {
+    let workspacePath;
+    let workspace;
+    if (workspacePathInput) {
+        if (!host.existsSync(workspacePathInput)) {
+            throw new Error(`Workspace path does not exist: ${workspacePathInput}. ` +
+                "You can use 'list_projects' to find available workspaces.");
+        }
+        if (!host.existsSync((0, node_path_1.join)(workspacePathInput, 'angular.json'))) {
+            throw new Error(`No angular.json found at ${workspacePathInput}. ` +
+                "You can use 'list_projects' to find available workspaces.");
+        }
+        workspacePath = workspacePathInput;
+        const configPath = (0, node_path_1.join)(workspacePath, 'angular.json');
+        try {
+            workspace = await config_1.AngularWorkspace.load(configPath);
+        }
+        catch (e) {
+            throw new Error(`Failed to load workspace configuration at ${configPath}: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    else if (mcpWorkspace) {
+        workspace = mcpWorkspace;
+        workspacePath = workspace.basePath;
+    }
+    else {
+        const found = findAngularJsonDir(process.cwd(), host);
+        if (!found) {
+            throw new Error('Could not find an Angular workspace (angular.json) in the current directory. ' +
+                "You can use 'list_projects' to find available workspaces.");
+        }
+        workspacePath = found;
+        const configPath = (0, node_path_1.join)(workspacePath, 'angular.json');
+        try {
+            workspace = await config_1.AngularWorkspace.load(configPath);
+        }
+        catch (e) {
+            throw new Error(`Failed to load workspace configuration at ${configPath}: ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    let projectName = projectNameInput;
+    if (projectName) {
+        if (!workspace.projects.has(projectName)) {
+            throw new Error(`Project '${projectName}' not found in workspace path ${workspacePath}. ` +
+                "You can use 'list_projects' to find available projects.");
+        }
+    }
+    else {
+        projectName = getDefaultProjectName(workspace);
+    }
+    if (!projectName) {
+        throw new Error(`No project name provided and no default project found in workspace path ${workspacePath}. ` +
+            'Please provide a project name or set a default project in angular.json. ' +
+            "You can use 'list_projects' to find available projects.");
+    }
+    return { workspace, workspacePath, projectName };
+}
+//# sourceMappingURL=workspace-utils.js.map

package/src/commands/mcp/workspace-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-utils.js","sourceRoot":"","sources":["workspace-utils.ts"],"names":[],"mappings":"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"}

package/src/commands/new/cli.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { Argv } from 'yargs';
+import { CommandModuleImplementation, CommandScope, Options, OtherOptions } from '../../command-builder/command-module';
+import { SchematicsCommandArgs, SchematicsCommandModule } from '../../command-builder/schematics-command-module';
+interface NewCommandArgs extends SchematicsCommandArgs {
+    collection?: string;
+}
+export default class NewCommandModule extends SchematicsCommandModule implements CommandModuleImplementation<NewCommandArgs> {
+    private readonly schematicName;
+    scope: CommandScope;
+    protected allowPrivateSchematics: boolean;
+    command: string;
+    aliases: string[] | undefined;
+    describe: string;
+    longDescriptionPath: string;
+    builder(argv: Argv): Promise<Argv<NewCommandArgs>>;
+    run(options: Options<NewCommandArgs> & OtherOptions): Promise<number | void>;
+    /** Find a collection from config that has an `ng-new` schematic. */
+    private getCollectionFromConfig;
+}
+export {};

package/src/commands/new/cli.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = require("node:path");
+const command_module_1 = require("../../command-builder/command-module");
+const schematics_command_module_1 = require("../../command-builder/schematics-command-module");
+const version_1 = require("../../utilities/version");
+const command_config_1 = require("../command-config");
+class NewCommandModule extends schematics_command_module_1.SchematicsCommandModule {
+    schematicName = 'ng-new';
+    scope = command_module_1.CommandScope.Out;
+    allowPrivateSchematics = true;
+    command = 'new [name]';
+    aliases = command_config_1.RootCommands['new'].aliases;
+    describe = 'Creates a new Angular workspace.';
+    longDescriptionPath = (0, node_path_1.join)(__dirname, 'long-description.md');
+    async builder(argv) {
+        const localYargs = (await super.builder(argv)).option('collection', {
+            alias: 'c',
+            describe: 'A collection of schematics to use in generating the initial application.',
+            type: 'string',
+        });
+        const { options: { collection: collectionNameFromArgs }, } = this.context.args;
+        const collectionName = typeof collectionNameFromArgs === 'string'
+            ? collectionNameFromArgs
+            : await this.getCollectionFromConfig();
+        const workflow = this.getOrCreateWorkflowForBuilder(collectionName);
+        const collection = workflow.engine.createCollection(collectionName);
+        const options = await this.getSchematicOptions(collection, this.schematicName, workflow);
+        return this.addSchemaOptionsToCommand(localYargs, options);
+    }
+    async run(options) {
+        // Register the version of the CLI in the registry.
+        const collectionName = options.collection ?? (await this.getCollectionFromConfig());
+        const { dryRun, force, interactive, defaults, collection, ...schematicOptions } = options;
+        const workflow = await this.getOrCreateWorkflowForExecution(collectionName, {
+            dryRun,
+            force,
+            interactive,
+            defaults,
+        });
+        workflow.registry.addSmartDefaultProvider('ng-cli-version', () => version_1.VERSION.full);
+        workflow.registry.addSmartDefaultProvider('packageManager', () => this.context.packageManager.name);
+        return this.runSchematic({
+            collectionName,
+            schematicName: this.schematicName,
+            schematicOptions,
+            executionOptions: {
+                dryRun,
+                force,
+                interactive,
+                defaults,
+            },
+        });
+    }
+    /** Find a collection from config that has an `ng-new` schematic. */
+    async getCollectionFromConfig() {
+        for (const collectionName of await this.getSchematicCollections()) {
+            const workflow = this.getOrCreateWorkflowForBuilder(collectionName);
+            const collection = workflow.engine.createCollection(collectionName);
+            const schematicsInCollection = collection.description.schematics;
+            if (Object.keys(schematicsInCollection).includes(this.schematicName)) {
+                return collectionName;
+            }
+        }
+        return schematics_command_module_1.DEFAULT_SCHEMATICS_COLLECTION;
+    }
+}
+exports.default = NewCommandModule;
+//# sourceMappingURL=cli.js.map

package/src/commands/new/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":"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"}

package/src/commands/new/long-description.md

@@ -0,0 +1,15 @@
+Creates and initializes a new Angular application that is the default project for a new workspace.
+
+Provides interactive prompts for optional configuration, such as adding routing support.
+All prompts can safely be allowed to default.
+
+- The new workspace folder is given the specified project name, and contains configuration files at the top level.
+
+- By default, the files for a new initial application (with the same name as the workspace) are placed in the `src/` subfolder.
+- The new application's configuration appears in the `projects` section of the `angular.json` workspace configuration file, under its project name.
+
+- Subsequent applications that you generate in the workspace reside in the `projects/` subfolder.
+
+If you plan to have multiple applications in the workspace, you can create an empty workspace by using the `--no-create-application` option.
+You can then use `ng generate application` to create an initial application.
+This allows a workspace name different from the initial app name, and ensures that all applications reside in the `/projects` subfolder, matching the structure of the configuration file.

package/src/commands/run/cli.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { Target } from '@angular-devkit/architect';
+import { Argv } from 'yargs';
+import { ArchitectBaseCommandModule } from '../../command-builder/architect-base-command-module';
+import { CommandModuleImplementation, CommandScope, Options, OtherOptions } from '../../command-builder/command-module';
+export interface RunCommandArgs {
+    target: string;
+}
+export default class RunCommandModule extends ArchitectBaseCommandModule<RunCommandArgs> implements CommandModuleImplementation<RunCommandArgs> {
+    scope: CommandScope;
+    command: string;
+    describe: string;
+    longDescriptionPath: string;
+    builder(argv: Argv): Promise<Argv<RunCommandArgs>>;
+    run(options: Options<RunCommandArgs> & OtherOptions): Promise<number>;
+    protected makeTargetSpecifier(options?: Options<RunCommandArgs>): Target | undefined;
+    /** @returns a sorted list of target specifiers to be used for auto completion. */
+    private getTargetChoices;
+}

package/src/commands/run/cli.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = require("node:path");
+const architect_base_command_module_1 = require("../../command-builder/architect-base-command-module");
+const command_module_1 = require("../../command-builder/command-module");
+class RunCommandModule extends architect_base_command_module_1.ArchitectBaseCommandModule {
+    scope = command_module_1.CommandScope.In;
+    command = 'run <target>';
+    describe = 'Runs an Architect target with an optional custom builder configuration defined in your project.';
+    longDescriptionPath = (0, node_path_1.join)(__dirname, 'long-description.md');
+    async builder(argv) {
+        const { jsonHelp, getYargsCompletions, help } = this.context.args.options;
+        const localYargs = argv
+            .positional('target', {
+            describe: 'The Architect target to run provided in the following format `project:target[:configuration]`.',
+            type: 'string',
+            demandOption: true,
+            // Show only in when using --help and auto completion because otherwise comma seperated configuration values will be invalid.
+            // Also, hide choices from JSON help so that we don't display them in AIO.
+            choices: (getYargsCompletions || help) && !jsonHelp ? this.getTargetChoices() : undefined,
+        })
+            .middleware((args) => {
+            // TODO: remove in version 15.
+            const { configuration, target } = args;
+            if (typeof configuration === 'string' && target) {
+                const targetWithConfig = target.split(':', 2);
+                targetWithConfig.push(configuration);
+                throw new command_module_1.CommandModuleError('Unknown argument: configuration.\n' +
+                    `Provide the configuration as part of the target 'ng run ${targetWithConfig.join(':')}'.`);
+            }
+        }, true)
+            .strict();
+        const target = this.makeTargetSpecifier();
+        if (!target) {
+            return localYargs;
+        }
+        const schemaOptions = await this.getArchitectTargetOptions(target);
+        return this.addSchemaOptionsToCommand(localYargs, schemaOptions);
+    }
+    async run(options) {
+        const target = this.makeTargetSpecifier(options);
+        const { target: _target, ...extraOptions } = options;
+        if (!target) {
+            throw new command_module_1.CommandModuleError('Cannot determine project or target.');
+        }
+        return this.runSingleTarget(target, extraOptions);
+    }
+    makeTargetSpecifier(options) {
+        const architectTarget = options?.target ?? this.context.args.positional[1];
+        if (!architectTarget) {
+            return undefined;
+        }
+        const [project = '', target = '', configuration] = architectTarget.split(':');
+        return {
+            project,
+            target,
+            configuration,
+        };
+    }
+    /** @returns a sorted list of target specifiers to be used for auto completion. */
+    getTargetChoices() {
+        if (!this.context.workspace) {
+            return;
+        }
+        const targets = [];
+        for (const [projectName, project] of this.context.workspace.projects) {
+            for (const [targetName, target] of project.targets) {
+                const currentTarget = `${projectName}:${targetName}`;
+                targets.push(currentTarget);
+                if (!target.configurations) {
+                    continue;
+                }
+                for (const configName of Object.keys(target.configurations)) {
+                    targets.push(`${currentTarget}:${configName}`);
+                }
+            }
+        }
+        return targets.sort();
+    }
+}
+exports.default = RunCommandModule;
+//# sourceMappingURL=cli.js.map

package/src/commands/run/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAGH,yCAAiC;AAEjC,uGAAiG;AACjG,yEAM8C;AAM9C,MAAqB,gBACnB,SAAQ,0DAA0C;IAGzC,KAAK,GAAG,6BAAY,CAAC,EAAE,CAAC;IAEjC,OAAO,GAAG,cAAc,CAAC;IACzB,QAAQ,GACN,iGAAiG,CAAC;IACpG,mBAAmB,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;IAE7D,KAAK,CAAC,OAAO,CAAC,IAAU;QACtB,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAE1E,MAAM,UAAU,GAAyB,IAAI;aAC1C,UAAU,CAAC,QAAQ,EAAE;YACpB,QAAQ,EACN,gGAAgG;YAClG,IAAI,EAAE,QAAQ;YACd,YAAY,EAAE,IAAI;YAClB,6HAA6H;YAC7H,0EAA0E;YAC1E,OAAO,EAAE,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,SAAS;SAC1F,CAAC;aACD,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE;YACnB,8BAA8B;YAC9B,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;YACvC,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,MAAM,EAAE,CAAC;gBAChD,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC9C,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBAErC,MAAM,IAAI,mCAAkB,CAC1B,oCAAoC;oBAClC,2DAA2D,gBAAgB,CAAC,IAAI,CAC9E,GAAG,CACJ,IAAI,CACR,CAAC;YACJ,CAAC;QACH,CAAC,EAAE,IAAI,CAAC;aACP,MAAM,EAAE,CAAC;QAEZ,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAEnE,OAAO,IAAI,CAAC,yBAAyB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAA+C;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;QAErD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,mCAAkB,CAAC,qCAAqC,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;IAES,mBAAmB,CAAC,OAAiC;QAC7D,MAAM,eAAe,GAAG,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,CAAC,OAAO,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,aAAa,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9E,OAAO;YACL,OAAO;YACP,MAAM;YACN,aAAa;SACd,CAAC;IACJ,CAAC;IAED,kFAAkF;IAC1E,gBAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;YACrE,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACnD,MAAM,aAAa,GAAG,GAAG,WAAW,IAAI,UAAU,EAAE,CAAC;gBACrD,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBAE5B,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;oBAC3B,SAAS;gBACX,CAAC;gBAED,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC5D,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,IAAI,UAAU,EAAE,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;CACF;AArGD,mCAqGC"}

package/src/commands/run/long-description.md

@@ -0,0 +1,10 @@
+Architect is the tool that the CLI uses to perform complex tasks such as compilation, according to provided configurations.
+The CLI commands run Architect targets such as `build`, `serve`, `test`, and `lint`.
+Each named target has a default configuration, specified by an `options` object,
+and an optional set of named alternate configurations in the `configurations` object.
+
+For example, the `serve` target for a newly generated app has a predefined
+alternate configuration named `production`.
+
+You can define new targets and their configuration options in the `architect` section
+of the `angular.json` file which you can run them from the command line using the `ng run` command.

package/src/commands/serve/cli.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { ArchitectCommandModule } from '../../command-builder/architect-command-module';
+import { CommandModuleImplementation } from '../../command-builder/command-module';
+export default class ServeCommandModule extends ArchitectCommandModule implements CommandModuleImplementation {
+    multiTarget: boolean;
+    command: string;
+    aliases: string[] | undefined;
+    describe: string;
+    longDescriptionPath?: string | undefined;
+}

package/src/commands/serve/cli.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const architect_command_module_1 = require("../../command-builder/architect-command-module");
+const command_config_1 = require("../command-config");
+class ServeCommandModule extends architect_command_module_1.ArchitectCommandModule {
+    multiTarget = false;
+    command = 'serve [project]';
+    aliases = command_config_1.RootCommands['serve'].aliases;
+    describe = 'Builds and serves your application, rebuilding on file changes.';
+    longDescriptionPath;
+}
+exports.default = ServeCommandModule;
+//# sourceMappingURL=cli.js.map