@angular/cli 20.1.0-rc.0 → 20.1.1

package/lib/config/schema.json

@@ -4299,7 +4299,7 @@
         },
         "watch": {
           "type": "boolean",
-          "description": "Run build when files change."
+          "description": "Re-run tests when source files change. Defaults to `true` in TTY environments and `false` otherwise."
         },
         "debug": {
           "type": "boolean",
@@ -4354,6 +4354,13 @@
           "type": "string",
           "description": "TypeScript file that exports an array of Angular providers to use during test execution. The array must be a default export.",
           "minLength": 1
+        },
+        "setupFiles": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "A list of global setup and configuration files that are included before the test files. The application's polyfills are always included before these files. The Angular Testbed is also initialized prior to the execution of these files."
         }
       },
       "additionalProperties": false,
@@ -4616,7 +4623,8 @@
         },
         "watch": {
           "type": "boolean",
-          "description": "Run build when files change."
+          "description": "Re-run tests when source files change.",
+          "default": true
         },
         "poll": {
           "type": "number",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular/cli",
-  "version": "20.1.0-rc.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-rc.0",
-    "@angular-devkit/core": "20.1.0-rc.0",
-    "@angular-devkit/schematics": "20.1.0-rc.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-rc.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",
@@ -41,19 +42,20 @@
     "pacote": "21.0.0",
     "resolve": "1.22.10",
     "semver": "7.7.2",
-    "yargs": "18.0.0"
+    "yargs": "18.0.0",
+    "zod": "3.25.75"
   },
   "ng-update": {
     "migrations": "@schematics/angular/migrations/migration-collection.json",
     "packageGroup": {
-      "@angular/cli": "20.1.0-rc.0",
-      "@angular/build": "20.1.0-rc.0",
-      "@angular/ssr": "20.1.0-rc.0",
-      "@angular-devkit/architect": "0.2001.0-rc.0",
-      "@angular-devkit/build-angular": "20.1.0-rc.0",
-      "@angular-devkit/build-webpack": "0.2001.0-rc.0",
-      "@angular-devkit/core": "20.1.0-rc.0",
-      "@angular-devkit/schematics": "20.1.0-rc.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

@@ -14,7 +14,9 @@ exports.createMcpServer = createMcpServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 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',
@@ -25,37 +27,82 @@ async function createMcpServer(context) {
         },
     });
     server.registerResource('instructions', 'instructions://best-practices', {
-        title: 'Angular System Instructions',
-        description: 'A set of instructions to help LLMs generate correct code that follows Angular 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)(node_path_1.default.join(__dirname, 'instructions', 'best-practices.md'), 'utf-8');
         return { contents: [{ uri: 'instructions://best-practices', text }] };
     });
     server.registerTool('list_projects', {
-        title: 'List projects',
-        description: 'List projects within an Angular workspace.' +
-            ' This information is read from the `angular.json` file at the root path of the Angular workspace',
-    }, () => {
-        if (!context.workspace) {
+        title: 'List Angular Projects',
+        description: 'Lists the names of all applications and libraries defined within an Angular workspace. ' +
+            'It reads the `angular.json` configuration file to identify the projects. ',
+        annotations: {
+            readOnlyHint: true,
+        },
+        outputSchema: {
+            projects: zod_1.z.array(zod_1.z.object({
+                name: zod_1.z
+                    .string()
+                    .describe('The name of the project, as defined in the `angular.json` file.'),
+                type: zod_1.z
+                    .enum(['application', 'library'])
+                    .optional()
+                    .describe(`The type of the project, either 'application' or 'library'.`),
+                root: zod_1.z
+                    .string()
+                    .describe('The root directory of the project, relative to the workspace root.'),
+                sourceRoot: zod_1.z
+                    .string()
+                    .describe(`The root directory of the project's source files, relative to the workspace root.`),
+                selectorPrefix: zod_1.z
+                    .string()
+                    .optional()
+                    .describe('The prefix to use for component selectors.' +
+                    ` For example, a prefix of 'app' would result in selectors like '<app-my-component>'.`),
+            })),
+        },
+    }, async () => {
+        const { workspace } = context;
+        if (!workspace) {
             return {
                 content: [
                     {
                         type: 'text',
-                        text: 'Not within an Angular project.',
+                        text: 'No Angular workspace found.' +
+                            ' An `angular.json` file, which marks the root of a workspace,' +
+                            ' could not be located in the current directory or any of its parent directories.',
                     },
                 ],
             };
         }
+        const projects = [];
+        // Convert to output format
+        for (const [name, project] of workspace.projects.entries()) {
+            projects.push({
+                name,
+                type: project.extensions['projectType'],
+                root: project.root,
+                sourceRoot: project.sourceRoot ?? node_path_1.default.posix.join(project.root, 'src'),
+                selectorPrefix: project.extensions['prefix'],
+            });
+        }
+        // The structuredContent field is newer and may not be supported by all hosts.
+        // A text representation of the content is also provided for compatibility.
         return {
             content: [
                 {
                     type: 'text',
-                    text: 'Projects in the Angular workspace: ' +
-                        [...context.workspace.projects.keys()].join(','),
+                    text: `Projects in the Angular workspace:\n${JSON.stringify(projects)}`,
                 },
             ],
+            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-rc.0');
+exports.VERSION = new Version('20.1.1');