@angular/cli 20.1.0 → 20.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/cli",
-  "version": "20.1.0",
+  "version": "20.1.1",
   "description": "CLI tool for Angular",
   "main": "lib/cli/index.js",
   "bin": {
@@ -25,14 +25,15 @@
   },
   "homepage": "https://github.com/angular/angular-cli",
   "dependencies": {
-    "@angular-devkit/architect": "0.2001.0",
-    "@angular-devkit/core": "20.1.0",
-    "@angular-devkit/schematics": "20.1.0",
+    "@angular-devkit/architect": "0.2001.1",
+    "@angular-devkit/core": "20.1.1",
+    "@angular-devkit/schematics": "20.1.1",
     "@inquirer/prompts": "7.6.0",
     "@listr2/prompt-adapter-inquirer": "2.0.22",
     "@modelcontextprotocol/sdk": "1.13.3",
-    "@schematics/angular": "20.1.0",
+    "@schematics/angular": "20.1.1",
     "@yarnpkg/lockfile": "1.1.0",
+    "algoliasearch": "5.32.0",
     "ini": "5.0.0",
     "jsonc-parser": "3.3.1",
     "listr2": "8.3.3",
@@ -47,14 +48,14 @@
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",
     "packageGroup": {
-      "@angular/cli": "20.1.0",
-      "@angular/build": "20.1.0",
-      "@angular/ssr": "20.1.0",
-      "@angular-devkit/architect": "0.2001.0",
-      "@angular-devkit/build-angular": "20.1.0",
-      "@angular-devkit/build-webpack": "0.2001.0",
-      "@angular-devkit/core": "20.1.0",
-      "@angular-devkit/schematics": "20.1.0"
+      "@angular/cli": "20.1.1",
+      "@angular/build": "20.1.1",
+      "@angular/ssr": "20.1.1",
+      "@angular-devkit/architect": "0.2001.1",
+      "@angular-devkit/build-angular": "20.1.1",
+      "@angular-devkit/build-webpack": "0.2001.1",
+      "@angular-devkit/core": "20.1.1",
+      "@angular-devkit/schematics": "20.1.1"
     }
   },
   "packageManager": "pnpm@9.15.9",

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

@@ -0,0 +1,10 @@
+/**
+ * @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 k1 = "@angular/cli";
+export declare const at = "QBHBbOdEO4CmBOC2d7jNmg==";
+export declare const iv: Buffer<ArrayBuffer>;

package/src/commands/mcp/constants.js

@@ -0,0 +1,15 @@
+"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.iv = exports.at = exports.k1 = void 0;
+exports.k1 = '@angular/cli';
+exports.at = 'QBHBbOdEO4CmBOC2d7jNmg==';
+exports.iv = Buffer.from([
+    0x97, 0xf4, 0x62, 0x95, 0x3e, 0x12, 0x76, 0x84, 0x8a, 0x09, 0x4a, 0xc9, 0xeb, 0xa2, 0x84, 0x69,
+]);

package/src/commands/mcp/mcp-server.js

@@ -16,6 +16,7 @@ const promises_1 = require("node:fs/promises");
 const node_path_1 = __importDefault(require("node:path"));
 const zod_1 = require("zod");
 const version_1 = require("../../utilities/version");
+const doc_search_1 = require("./tools/doc-search");
 async function createMcpServer(context) {
     const server = new mcp_js_1.McpServer({
         name: 'angular-cli-server',
@@ -102,5 +103,6 @@ async function createMcpServer(context) {
             structuredContent: { projects },
         };
     });
+    await (0, doc_search_1.registerDocSearchTool)(server);
     return server;
 }

package/src/commands/mcp/tools/doc-search.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 type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Registers a tool with the MCP server to search the Angular documentation.
+ *
+ * This tool uses Algolia to search the official Angular documentation.
+ *
+ * @param server The MCP server instance with which to register the tool.
+ */
+export declare function registerDocSearchTool(server: McpServer): Promise<void>;

package/src/commands/mcp/tools/doc-search.js

@@ -0,0 +1,130 @@
+"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
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDocSearchTool = registerDocSearchTool;
+const node_crypto_1 = require("node:crypto");
+const zod_1 = require("zod");
+const constants_1 = require("../constants");
+const ALGOLIA_APP_ID = 'L1XWT2UJ7F';
+// https://www.algolia.com/doc/guides/security/api-keys/#search-only-api-key
+// This is a search only, rate limited key. It is sent within the URL of the query request.
+// This is not the actual key.
+const ALGOLIA_API_E = '322d89dab5f2080fe09b795c93413c6a89222b13a447cdf3e6486d692717bc0c';
+/**
+ * Registers a tool with the MCP server to search the Angular documentation.
+ *
+ * This tool uses Algolia to search the official Angular documentation.
+ *
+ * @param server The MCP server instance with which to register the tool.
+ */
+async function registerDocSearchTool(server) {
+    let client;
+    server.registerTool('search_documentation', {
+        title: 'Search Angular Documentation (angular.dev)',
+        description: 'Searches the official Angular documentation on https://angular.dev.' +
+            ' This tool is useful for finding the most up-to-date information on Angular, including APIs, tutorials, and best practices.' +
+            ' Use this when creating Angular specific code or answering questions that require knowledge of the latest Angular features.',
+        annotations: {
+            readOnlyHint: true,
+        },
+        inputSchema: {
+            query: zod_1.z
+                .string()
+                .describe('The search query to use when searching the Angular documentation.' +
+                ' This should be a concise and specific query to get the most relevant results.'),
+        },
+    }, async ({ query }) => {
+        if (!client) {
+            const dcip = (0, node_crypto_1.createDecipheriv)('aes-256-gcm', (constants_1.k1 + ALGOLIA_APP_ID).padEnd(32, '^'), constants_1.iv).setAuthTag(Buffer.from(constants_1.at, 'base64'));
+            const { searchClient } = await Promise.resolve().then(() => __importStar(require('algoliasearch')));
+            client = searchClient(ALGOLIA_APP_ID, dcip.update(ALGOLIA_API_E, 'hex', 'utf-8') + dcip.final('utf-8'));
+        }
+        const { results } = await client.search(createSearchArguments(query));
+        // Convert results into text content entries instead of stringifying the entire object
+        const content = results.flatMap((result) => result.hits.map((hit) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const hierarchy = Object.values(hit.hierarchy).filter((x) => typeof x === 'string');
+            const title = hierarchy.pop();
+            const description = hierarchy.join(' > ');
+            return {
+                type: 'text',
+                text: `## ${title}\n${description}\nURL: ${hit.url}`,
+            };
+        }));
+        return { content };
+    });
+}
+/**
+ * Creates the search arguments for an Algolia search.
+ *
+ * The arguments are based on the search implementation in `adev`.
+ *
+ * @param query The search query string.
+ * @returns The search arguments for the Algolia client.
+ */
+function createSearchArguments(query) {
+    // Search arguments are based on adev's search service:
+    // https://github.com/angular/angular/blob/4b614fbb3263d344dbb1b18fff24cb09c5a7582d/adev/shared-docs/services/search.service.ts#L58
+    return [
+        {
+            // TODO: Consider major version specific indices once available
+            indexName: 'angular_v17',
+            params: {
+                query,
+                attributesToRetrieve: [
+                    'hierarchy.lvl0',
+                    'hierarchy.lvl1',
+                    'hierarchy.lvl2',
+                    'hierarchy.lvl3',
+                    'hierarchy.lvl4',
+                    'hierarchy.lvl5',
+                    'hierarchy.lvl6',
+                    'content',
+                    'type',
+                    'url',
+                ],
+                hitsPerPage: 10,
+            },
+            type: 'default',
+        },
+    ];
+}

package/src/utilities/version.js

@@ -22,4 +22,4 @@ class Version {
         this.patch = patch;
     }
 }
-exports.VERSION = new Version('20.1.0');
+exports.VERSION = new Version('20.1.1');

package/src/commands/mcp/component-generation-prompt.md

@@ -1,60 +0,0 @@
-# Angular Component Generation Prompt
-
-## Role and Goal
-
-You are an expert Angular developer specializing in creating modern, high-quality components. Your goal is to generate a new Angular component based on user requirements, ensuring it follows the latest best practices and style guidelines.
-
-## Context
-
-You are operating within an existing Angular CLI project. You have access to the project's file system and can use tools to interact with the Angular CLI for code generation.
-
-## Instructions
-
-Follow these steps to fulfill the user's request:
-
-### 1. Analyze the User's Request
-
-Carefully analyze the user's instructions to extract the following details:
-
--   **Component Name:** The desired name for the component (e.g., 'UserProfile', 'LoginFormComponent'). Use this to form the file name and selector.
--   **Inputs/Outputs:** Any `input()` or `output()` properties the component needs.
--   **Component Logic:** The business logic, properties, and methods to be implemented in the component's class.
--   **Template Structure:** The HTML structure for the component's template.
--   **Styling:** Any CSS styles or style requirements for the component.
--   **CLI Options:** Any specific options for the `ng generate` command, such as `--style=scss`, `--skip-tests=true`, `--view-encapsulation=Emulated`, etc.
-
-### 2. Generate the Base Component
-
-You MUST generate the initial component files using the Angular CLI. Use the following methods in order of preference:
-
-**Preference 1: Use the `generate_component` tool (if available)**
-
--   This is the preferred method.
--   Use the details extracted from the user's request to provide the necessary parameters.
--   Always generate a **standalone** component unless explicitly told otherwise.
-
-**Preference 2: Use the `run_shell_command` tool**
-
--   If a dedicated `generate_component` tool is not available, fall back to using the shell command.
--   Construct the command like this: `ng generate component <component-name> [options...]`
--   **Default Options:** Always include `--standalone` to create a standalone component.
--   **User-Defined Options:** Add any other options derived from the user's request.
-
-### 3. Read the Generated Files
-
-After the CLI has generated the base files, use the `read_file` tool to get the content of the newly created:
--   Component TypeScript file (`<component-name>.component.ts`)
--   Component template file (`<component-name>.component.html`)
--   Component stylesheet (`<component-name>.component.css`, etc.)
-
-### 4. Modify the Code
-
-Modify the code from the generated files to implement the specific logic, template, and styling from the user's instructions. Ensure the final code is complete, correct, and adheres to the latest Angular best practices.
-
--   **Class:** Add the required properties, `input()`/`output()` functions, methods, and other logic to the component's class.
--   **Template:** Build the HTML structure in the template file. Use native control flow (`@if`, `@for`, `@switch`) instead of structural directives (`*ngIf`, `*ngFor`).
--   **Stylesheet:** Add the necessary styles to the stylesheet.
-
-### 5. Final Output
-
-Present the complete, final code for each modified file. Do not show diffs or partial code snippets. The user should be able to copy and paste the code directly into their project.