@depup/angular__cli 21.2.1-depup.1

package/src/commands/mcp/resources/best-practices.md

@@ -0,0 +1,54 @@
+You are an expert in TypeScript, Angular, and scalable web application development. You write functional, maintainable, performant, and accessible code following Angular and TypeScript best practices.
+
+## TypeScript Best Practices
+
+- Use strict type checking
+- Prefer type inference when the type is obvious
+- Avoid the `any` type; use `unknown` when type is uncertain
+
+## Angular Best Practices
+
+- Always use standalone components over NgModules
+- Must NOT set `standalone: true` inside Angular decorators. It's the default in Angular v20+.
+- Use signals for state management
+- Implement lazy loading for feature routes
+- Do NOT use the `@HostBinding` and `@HostListener` decorators. Put host bindings inside the `host` object of the `@Component` or `@Directive` decorator instead
+- Use `NgOptimizedImage` for all static images.
+  - `NgOptimizedImage` does not work for inline base64 images.
+
+## Accessibility Requirements
+
+- It MUST pass all AXE checks.
+- It MUST follow all WCAG AA minimums, including focus management, color contrast, and ARIA attributes.
+
+### Components
+
+- Keep components small and focused on a single responsibility
+- Use `input()` and `output()` functions instead of decorators
+- Use `computed()` for derived state
+- Set `changeDetection: ChangeDetectionStrategy.OnPush` in `@Component` decorator
+- Prefer inline templates for small components
+- Prefer Reactive forms instead of Template-driven ones
+- Do NOT use `ngClass`, use `class` bindings instead
+- Do NOT use `ngStyle`, use `style` bindings instead
+- When using external templates/styles, use paths relative to the component TS file.
+
+## State Management
+
+- Use signals for local component state
+- Use `computed()` for derived state
+- Keep state transformations pure and predictable
+- Do NOT use `mutate` on signals, use `update` or `set` instead
+
+## Templates
+
+- Keep templates simple and avoid complex logic
+- Use native control flow (`@if`, `@for`, `@switch`) instead of `*ngIf`, `*ngFor`, `*ngSwitch`
+- Use the async pipe to handle observables
+- Do not assume globals like (`new Date()`) are available.
+
+## Services
+
+- Design services around a single responsibility
+- Use the `providedIn: 'root'` option for singleton services
+- Use the `inject()` function instead of constructor injection

package/src/commands/mcp/resources/instructions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @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 } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerInstructionsResource(server: McpServer): void;

package/src/commands/mcp/resources/instructions.js

@@ -0,0 +1,26 @@
+"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.registerInstructionsResource = registerInstructionsResource;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+function registerInstructionsResource(server) {
+    server.registerResource('instructions', 'instructions://best-practices', {
+        title: 'Angular Best Practices and Code Generation Guide',
+        description: "A comprehensive guide detailing Angular's best practices for code generation and development." +
+            ' This guide should be used as a reference by an LLM to ensure any generated code' +
+            ' adheres to modern Angular standards, including the use of standalone components,' +
+            ' typed forms, modern control flow syntax, and other current conventions.',
+        mimeType: 'text/markdown',
+    }, async () => {
+        const text = await (0, promises_1.readFile)((0, node_path_1.join)(__dirname, 'best-practices.md'), 'utf-8');
+        return { contents: [{ uri: 'instructions://best-practices', text }] };
+    });
+}
+//# sourceMappingURL=instructions.js.map

package/src/commands/mcp/resources/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["instructions.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAMH,oEAmBC;AAtBD,+CAA4C;AAC5C,yCAAiC;AAEjC,SAAgB,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,CAAC,gBAAgB,CACrB,cAAc,EACd,+BAA+B,EAC/B;QACE,KAAK,EAAE,kDAAkD;QACzD,WAAW,EACT,+FAA+F;YAC/F,kFAAkF;YAClF,mFAAmF;YACnF,0EAA0E;QAC5E,QAAQ,EAAE,eAAe;KAC1B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CAAC;QAE3E,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,+BAA+B,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACxE,CAAC,CACF,CAAC;AACJ,CAAC"}

package/src/commands/mcp/shared-options.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @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 { z } from 'zod';
+export declare const workspaceAndProjectOptions: {
+    workspace: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+};

package/src/commands/mcp/shared-options.js

@@ -0,0 +1,22 @@
+"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.workspaceAndProjectOptions = void 0;
+const zod_1 = require("zod");
+exports.workspaceAndProjectOptions = {
+    workspace: zod_1.z
+        .string()
+        .optional()
+        .describe('The path to the workspace directory (containing angular.json). If not provided, uses the current directory.'),
+    project: zod_1.z
+        .string()
+        .optional()
+        .describe('Which project to target in a monorepo context. If not provided, targets the default project.'),
+};
+//# sourceMappingURL=shared-options.js.map

package/src/commands/mcp/shared-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-options.js","sourceRoot":"","sources":["shared-options.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6BAAwB;AAEX,QAAA,0BAA0B,GAAG;IACxC,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6GAA6G,CAC9G;IACH,OAAO,EAAE,OAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,8FAA8F,CAC/F;CACJ,CAAC"}

package/src/commands/mcp/tools/ai-tutor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @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
+ */
+export declare const AI_TUTOR_TOOL: import("./tool-registry").McpToolDeclaration<Readonly<{
+    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+}>, Readonly<{
+    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+}>>;

package/src/commands/mcp/tools/ai-tutor.js

@@ -0,0 +1,59 @@
+"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.AI_TUTOR_TOOL = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const tool_registry_1 = require("./tool-registry");
+exports.AI_TUTOR_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'ai_tutor',
+    title: 'Start Angular AI Tutor',
+    description: `
+<Purpose>
+Loads the core instructions, curriculum, and persona for the Angular AI Tutor.
+This tool acts as a RAG (Retrieval-Augmented Generation) source, effectively
+reprogramming the assistant to become a specialized Angular tutor by providing it
+with a new core identity and knowledge base.
+</Purpose>
+<Use Cases>
+* The user asks to start a guided, step-by-step tutorial for learning Angular (e.g., "teach me Angular," "start the tutorial").
+* The user asks to resume a previous tutoring session.
+</Use Cases>
+<Operational Notes>
+* The text returned by this tool is a new set of instructions and rules for you, the LLM. It is NOT meant to be displayed to the user.
+* After invoking this tool, you MUST adopt the persona of the Angular AI Tutor and follow the curriculum provided in the text.
+* Be aware that the tutor persona supports special user commands, such as "skip this section," "show the table of contents,"
+  or "set my experience level to beginner." The curriculum text will provide the full details on how to handle these.
+* Your subsequent responses should be governed by these new instructions, leading the user through the "Smart Recipe Box"
+  application tutorial.
+* As the tutor, you will use your other tools to access the user's project files to verify their solutions as instructed by the curriculum.
+</Operational Notes>
+`,
+    isReadOnly: true,
+    isLocalOnly: true,
+    factory: () => {
+        let aiTutorText;
+        return async () => {
+            aiTutorText ??= await (0, promises_1.readFile)((0, node_path_1.join)(__dirname, '../resources/ai-tutor.md'), 'utf-8');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: aiTutorText,
+                        annotations: {
+                            audience: ['assistant'],
+                            priority: 1.0,
+                        },
+                    },
+                ],
+            };
+        };
+    },
+});
+//# sourceMappingURL=ai-tutor.js.map

package/src/commands/mcp/tools/ai-tutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tutor.js","sourceRoot":"","sources":["ai-tutor.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,+CAA4C;AAC5C,yCAAiC;AACjC,mDAA8C;AAEjC,QAAA,aAAa,GAAG,IAAA,2BAAW,EAAC;IACvC,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;CAoBd;IACC,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,GAAG,EAAE;QACZ,IAAI,WAAmB,CAAC;QAExB,OAAO,KAAK,IAAI,EAAE;YAChB,WAAW,KAAK,MAAM,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,0BAA0B,CAAC,EAAE,OAAO,CAAC,CAAC;YAErF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,WAAW;wBACjB,WAAW,EAAE;4BACX,QAAQ,EAAE,CAAC,WAAW,CAAC;4BACvB,QAAQ,EAAE,GAAG;yBACd;qBACF;iBACF;aACF,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/src/commands/mcp/tools/best-practices.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @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 { z } from 'zod';
+export declare const BEST_PRACTICES_TOOL: import("./tool-registry").McpToolDeclaration<{
+    workspacePath: z.ZodOptional<z.ZodString>;
+}, Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>>;

package/src/commands/mcp/tools/best-practices.js

@@ -0,0 +1,187 @@
+"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.BEST_PRACTICES_TOOL = void 0;
+/**
+ * @fileoverview
+ * This file defines the `get_best_practices` MCP tool. The tool is designed to be version-aware,
+ * dynamically resolving the best practices guide from the user's installed version of
+ * `@angular/core`. It achieves this by reading a custom `angular` metadata block in the
+ * framework's `package.json`. If this resolution fails, it gracefully falls back to a generic
+ * guide bundled with the Angular CLI.
+ */
+const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
+const node_path_1 = require("node:path");
+const zod_1 = require("zod");
+const version_1 = require("../../../utilities/version");
+const tool_registry_1 = require("./tool-registry");
+const bestPracticesInputSchema = zod_1.z.object({
+    workspacePath: zod_1.z
+        .string()
+        .optional()
+        .describe('The absolute path to the `angular.json` file for the workspace. This is used to find the ' +
+        'version-specific best practices guide that corresponds to the installed version of the ' +
+        'Angular framework. You **MUST** get this path from the `list_projects` tool. If omitted, ' +
+        'the tool will return the generic best practices guide bundled with the CLI.'),
+});
+exports.BEST_PRACTICES_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'get_best_practices',
+    title: 'Get Angular Coding Best Practices Guide',
+    description: `
+<Purpose>
+Retrieves the official Angular Best Practices Guide. This guide contains the essential rules and conventions
+that **MUST** be followed for any task involving the creation, analysis, or modification of Angular code.
+</Purpose>
+<Use Cases>
+* As a mandatory first step before writing or modifying any Angular code to ensure adherence to modern standards.
+* To learn about key concepts like standalone components, typed forms, and modern control flow syntax (@if, @for, @switch).
+* To verify that existing code aligns with current Angular conventions before making changes.
+</Use Cases>
+<Operational Notes>
+* **Project-Specific Use (Recommended):** For tasks inside a user's project, you **MUST** provide the
+  \`workspacePath\` argument to get the guide that matches the project's Angular version. Get this
+  path from \`list_projects\`.
+* **General Use:** If no project context is available (e.g., for general questions or learning),
+  you can call the tool without the \`workspacePath\` argument. It will return the latest
+  generic best practices guide.
+* The content of this guide is non-negotiable and reflects the official, up-to-date standards for Angular development.
+* You **MUST** internalize and apply the principles from this guide in all subsequent Angular-related tasks.
+* Failure to adhere to these best practices will result in suboptimal and outdated code.
+</Operational Notes>`,
+    inputSchema: bestPracticesInputSchema.shape,
+    isReadOnly: true,
+    isLocalOnly: true,
+    factory: createBestPracticesHandler,
+});
+/**
+ * Retrieves the content of the generic best practices guide that is bundled with the CLI.
+ * This serves as a fallback when a version-specific guide cannot be found.
+ * @returns A promise that resolves to the string content of the bundled markdown file.
+ */
+async function getBundledBestPractices() {
+    return (0, promises_1.readFile)((0, node_path_1.join)(__dirname, '../resources/best-practices.md'), 'utf-8');
+}
+/**
+ * Attempts to find and read a version-specific best practices guide from the user's installed
+ * version of `@angular/core`. It looks for a custom `angular` metadata property in the
+ * framework's `package.json` to locate the guide.
+ *
+ * @example A sample `package.json` `angular` field:
+ * ```json
+ * {
+ *   "angular": {
+ *     "bestPractices": {
+ *       "format": "markdown",
+ *       "path": "./resources/best-practices.md"
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @param workspacePath The absolute path to the user's `angular.json` file.
+ * @param logger The MCP tool context logger for reporting warnings.
+ * @returns A promise that resolves to an object containing the guide's content and source,
+ *     or `undefined` if the guide could not be resolved.
+ */
+async function getVersionSpecificBestPractices(workspacePath, logger) {
+    // 1. Resolve the path to package.json
+    let pkgJsonPath;
+    try {
+        const workspaceRequire = (0, node_module_1.createRequire)(workspacePath);
+        pkgJsonPath = workspaceRequire.resolve('@angular/core/package.json');
+    }
+    catch (e) {
+        logger.warn(`Could not resolve '@angular/core/package.json' from '${workspacePath}'. ` +
+            'Is Angular installed in this project? Falling back to the bundled guide.');
+        return undefined;
+    }
+    // 2. Read and parse package.json, then find and read the guide.
+    try {
+        const pkgJsonContent = await (0, promises_1.readFile)(pkgJsonPath, 'utf-8');
+        const pkgJson = JSON.parse(pkgJsonContent);
+        const bestPracticesInfo = pkgJson['angular']?.bestPractices;
+        if (bestPracticesInfo &&
+            bestPracticesInfo.format === 'markdown' &&
+            typeof bestPracticesInfo.path === 'string') {
+            const packageDirectory = (0, node_path_1.dirname)(pkgJsonPath);
+            const guidePath = (0, node_path_1.resolve)(packageDirectory, bestPracticesInfo.path);
+            // Ensure the resolved guide path is within the package boundary.
+            // Uses path.relative to create a cross-platform, case-insensitive check.
+            // If the relative path starts with '..' or is absolute, it is a traversal attempt.
+            const relativePath = (0, node_path_1.relative)(packageDirectory, guidePath);
+            if (relativePath.startsWith('..') || (0, node_path_1.isAbsolute)(relativePath)) {
+                logger.warn(`Detected a potential path traversal attempt in '${pkgJsonPath}'. ` +
+                    `The path '${bestPracticesInfo.path}' escapes the package boundary. ` +
+                    'Falling back to the bundled guide.');
+                return undefined;
+            }
+            // Check the file size to prevent reading a very large file.
+            const stats = await (0, promises_1.stat)(guidePath);
+            if (stats.size > 1024 * 1024) {
+                // 1MB
+                logger.warn(`The best practices guide at '${guidePath}' is larger than 1MB (${stats.size} bytes). ` +
+                    'This is unexpected and the file will not be read. Falling back to the bundled guide.');
+                return undefined;
+            }
+            const content = await (0, promises_1.readFile)(guidePath, 'utf-8');
+            const source = `framework version ${pkgJson.version}`;
+            return { content, source };
+        }
+        else {
+            logger.warn(`Did not find valid 'angular.bestPractices' metadata in '${pkgJsonPath}'. ` +
+                'Falling back to the bundled guide.');
+        }
+    }
+    catch (e) {
+        logger.warn(`Failed to read or parse version-specific best practices referenced in '${pkgJsonPath}': ${e instanceof Error ? e.message : e}. Falling back to the bundled guide.`);
+    }
+    return undefined;
+}
+/**
+ * Creates the handler function for the `get_best_practices` tool.
+ * The handler orchestrates the process of first attempting to get a version-specific guide
+ * and then falling back to the bundled guide if necessary.
+ * @param context The MCP tool context, containing the logger.
+ * @returns An async function that serves as the tool's executor.
+ */
+function createBestPracticesHandler({ logger }) {
+    let bundledBestPractices;
+    return async (input) => {
+        let content;
+        let source;
+        // First, try to get the version-specific guide.
+        if (input.workspacePath) {
+            const versionSpecific = await getVersionSpecificBestPractices(input.workspacePath, logger);
+            if (versionSpecific) {
+                content = versionSpecific.content;
+                source = versionSpecific.source;
+            }
+        }
+        // If the version-specific guide was not found for any reason, fall back to the bundled version.
+        if (content === undefined) {
+            content = await (bundledBestPractices ??= getBundledBestPractices());
+            source = `bundled (CLI v${version_1.VERSION.full})`;
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: content,
+                    annotations: {
+                        audience: ['assistant'],
+                        priority: 0.9,
+                        source,
+                    },
+                },
+            ],
+        };
+    };
+}
+//# sourceMappingURL=best-practices.js.map

package/src/commands/mcp/tools/best-practices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-practices.js","sourceRoot":"","sources":["best-practices.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH;;;;;;;GAOG;AAEH,+CAAkD;AAClD,6CAA4C;AAC5C,yCAAyE;AACzE,6BAAwB;AACxB,wDAAqD;AACrD,mDAAmE;AAEnE,MAAM,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,aAAa,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2FAA2F;QACzF,yFAAyF;QACzF,2FAA2F;QAC3F,6EAA6E,CAChF;CACJ,CAAC,CAAC;AAIU,QAAA,mBAAmB,GAAG,IAAA,2BAAW,EAAC;IAC7C,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,yCAAyC;IAChD,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;qBAoBM;IACnB,WAAW,EAAE,wBAAwB,CAAC,KAAK;IAC3C,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,0BAA0B;CACpC,CAAC,CAAC;AAEH;;;;GAIG;AACH,KAAK,UAAU,uBAAuB;IACpC,OAAO,IAAA,mBAAQ,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,gCAAgC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,KAAK,UAAU,+BAA+B,CAC5C,aAAqB,EACrB,MAAgC;IAEhC,sCAAsC;IACtC,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,IAAA,2BAAa,EAAC,aAAa,CAAC,CAAC;QACtD,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CACT,wDAAwD,aAAa,KAAK;YACxE,0EAA0E,CAC7E,CAAC;QAEF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gEAAgE;IAChE,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,IAAA,mBAAQ,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC3C,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;QAE5D,IACE,iBAAiB;YACjB,iBAAiB,CAAC,MAAM,KAAK,UAAU;YACvC,OAAO,iBAAiB,CAAC,IAAI,KAAK,QAAQ,EAC1C,CAAC;YACD,MAAM,gBAAgB,GAAG,IAAA,mBAAO,EAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,IAAA,mBAAO,EAAC,gBAAgB,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAEpE,iEAAiE;YACjE,yEAAyE;YACzE,mFAAmF;YACnF,MAAM,YAAY,GAAG,IAAA,oBAAQ,EAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;YAC3D,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAA,sBAAU,EAAC,YAAY,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,IAAI,CACT,mDAAmD,WAAW,KAAK;oBACjE,aAAa,iBAAiB,CAAC,IAAI,kCAAkC;oBACrE,oCAAoC,CACvC,CAAC;gBAEF,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,4DAA4D;YAC5D,MAAM,KAAK,GAAG,MAAM,IAAA,eAAI,EAAC,SAAS,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;gBAC7B,MAAM;gBACN,MAAM,CAAC,IAAI,CACT,gCAAgC,SAAS,yBAAyB,KAAK,CAAC,IAAI,WAAW;oBACrF,sFAAsF,CACzF,CAAC;gBAEF,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,qBAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;YAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CACT,2DAA2D,WAAW,KAAK;gBACzE,oCAAoC,CACvC,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CACT,0EAA0E,WAAW,MACnF,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CACnC,sCAAsC,CACvC,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,0BAA0B,CAAC,EAAE,MAAM,EAAkB;IAC5D,IAAI,oBAAqC,CAAC;IAE1C,OAAO,KAAK,EAAE,KAAyB,EAAE,EAAE;QACzC,IAAI,OAA2B,CAAC;QAChC,IAAI,MAA0B,CAAC;QAE/B,gDAAgD;QAChD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,eAAe,GAAG,MAAM,+BAA+B,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YAC3F,IAAI,eAAe,EAAE,CAAC;gBACpB,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC;gBAClC,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC;YAClC,CAAC;QACH,CAAC;QAED,gGAAgG;QAChG,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,GAAG,MAAM,CAAC,oBAAoB,KAAK,uBAAuB,EAAE,CAAC,CAAC;YACrE,MAAM,GAAG,iBAAiB,iBAAO,CAAC,IAAI,GAAG,CAAC;QAC5C,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE;wBACX,QAAQ,EAAE,CAAC,WAAoB,CAAC;wBAChC,QAAQ,EAAE,GAAG;wBACb,MAAM;qBACP;iBACF;aACF;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/src/commands/mcp/tools/build.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @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 { z } from 'zod';
+import { type McpToolContext, type McpToolDeclaration } from './tool-registry';
+declare const buildToolInputSchema: z.ZodObject<{
+    configuration: z.ZodOptional<z.ZodString>;
+    workspace: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BuildToolInput = z.infer<typeof buildToolInputSchema>;
+declare const buildToolOutputSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        success: "success";
+        failure: "failure";
+    }>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BuildToolOutput = z.infer<typeof buildToolOutputSchema>;
+export declare function runBuild(input: BuildToolInput, context: McpToolContext): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        status: "success" | "failure";
+        logs?: string[] | undefined;
+        path?: string | undefined;
+    };
+}>;
+export declare const BUILD_TOOL: McpToolDeclaration<typeof buildToolInputSchema.shape, typeof buildToolOutputSchema.shape>;
+export {};

package/src/commands/mcp/tools/build.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 });
+exports.BUILD_TOOL = void 0;
+exports.runBuild = runBuild;
+const zod_1 = require("zod");
+const shared_options_1 = require("../shared-options");
+const utils_1 = require("../utils");
+const workspace_utils_1 = require("../workspace-utils");
+const tool_registry_1 = require("./tool-registry");
+const DEFAULT_CONFIGURATION = 'development';
+const buildStatusSchema = zod_1.z.enum(['success', 'failure']);
+const buildToolInputSchema = zod_1.z.object({
+    ...shared_options_1.workspaceAndProjectOptions,
+    configuration: zod_1.z
+        .string()
+        .optional()
+        .describe('Which build configuration to use. Defaults to "development".'),
+});
+const buildToolOutputSchema = zod_1.z.object({
+    status: buildStatusSchema.describe('Build status.'),
+    logs: zod_1.z.array(zod_1.z.string()).optional().describe('Output logs from `ng build`.'),
+    path: zod_1.z.string().optional().describe('The output location for the build, if successful.'),
+});
+async function runBuild(input, context) {
+    const { workspacePath, projectName } = await (0, workspace_utils_1.resolveWorkspaceAndProject)({
+        host: context.host,
+        workspacePathInput: input.workspace,
+        projectNameInput: input.project,
+        mcpWorkspace: context.workspace,
+    });
+    // Build "ng"'s command line.
+    const args = ['build', projectName, '-c', input.configuration ?? DEFAULT_CONFIGURATION];
+    let status = 'success';
+    let logs = [];
+    let outputPath;
+    try {
+        logs = (await context.host.runCommand('ng', args, { cwd: workspacePath })).logs;
+    }
+    catch (e) {
+        status = 'failure';
+        logs = (0, utils_1.getCommandErrorLogs)(e);
+    }
+    for (const line of logs) {
+        const match = line.match(/Output location: (.*)/);
+        if (match) {
+            outputPath = match[1].trim();
+            break;
+        }
+    }
+    const structuredContent = {
+        status,
+        logs,
+        path: outputPath,
+    };
+    return (0, utils_1.createStructuredContentOutput)(structuredContent);
+}
+exports.BUILD_TOOL = (0, tool_registry_1.declareTool)({
+    name: 'build',
+    title: 'Build Tool',
+    description: `
+<Purpose>
+Perform a one-off, non-watched build using "ng build". Use this tool whenever the user wants to build an Angular project; this is similar to
+"ng build", but the tool is smarter about using the right configuration and collecting the output logs.
+</Purpose>
+<Use Cases>
+* Building an Angular project and getting build logs back.
+</Use Cases>
+<Operational Notes>
+* This tool runs "ng build" so it expects to run within an Angular workspace.
+* If you want a watched build which updates as files are changed, use "devserver.start" instead, which also serves the app.
+* You can provide a project instead of building the root one. The "list_projects" MCP tool could be used to obtain the list of projects.
+* This tool defaults to a development environment while a regular "ng build" defaults to a production environment. An unexpected build
+  failure might suggest the project is not configured for the requested environment.
+</Operational Notes>
+`,
+    isReadOnly: false,
+    isLocalOnly: true,
+    inputSchema: buildToolInputSchema.shape,
+    outputSchema: buildToolOutputSchema.shape,
+    factory: (context) => (input) => runBuild(input, context),
+});
+//# sourceMappingURL=build.js.map

package/src/commands/mcp/tools/build.js.map

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

package/src/commands/mcp/tools/devserver/devserver-start.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @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 { z } from 'zod';
+import { type McpToolContext, type McpToolDeclaration } from '../tool-registry';
+declare const devserverStartToolInputSchema: z.ZodObject<{
+    workspace: z.ZodOptional<z.ZodString>;
+    project: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DevserverStartToolInput = z.infer<typeof devserverStartToolInputSchema>;
+declare const devserverStartToolOutputSchema: z.ZodObject<{
+    message: z.ZodString;
+    address: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DevserverStartToolOutput = z.infer<typeof devserverStartToolOutputSchema>;
+export declare function startDevserver(input: DevserverStartToolInput, context: McpToolContext): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: {
+        message: string;
+        address: string;
+    };
+}>;
+export declare const DEVSERVER_START_TOOL: McpToolDeclaration<typeof devserverStartToolInputSchema.shape, typeof devserverStartToolOutputSchema.shape>;
+export {};